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Develop together 
especially now: 


These are not easy times for any of us. Fortunately, my colleagues and I can work well 
from our home offices. The fact that we no longer have to commute to the office and 
that we can dress a little more casually means that we have a lot of free time to spend on 
our favorite hobbies during the week. I’m planning to take a look at the new Raspberry 
Pi soon. I’m also interested in machine learning. (A few small ideas about what you can 
do with it in connection with music/video are already ripening.) 


Maybe you too have had some more time and have used it to finally realize an old project 
idea? Maybe with one of the small boards you picked up at one of the last (real) fairs? Or 
with one of the development modules from our store? If so, don’t hesitate to let us and our 
readers know! On our platform www.elektormagazine.com/labs, you can create a project 
today and briefly describe what you are planning or have already developed. Neither good 
English nor full documentation is required there. You can submit additional material 
later. I'm almost certain that someone will quickly post a question about your project or 
tell you that they've already done something similar (and where the pitfalls might be). 
Things develop better together, and the network of networks makes it possible for this 
to work even during a lockdown! 











We editors also look at the Labs projects regularly. None of the projects are forgotten. Our 
goal for 2021 is to quickly select what might be suitable for publication in our magazine. 
Of course, this also applies to submissions you send us by mail! An editor from our team 
will then contact you and look after your article proposal. 


So, let's develop together and stay healthy! 
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Next Edition 


Elektor Magazine Edition 2/2021 (March & April) 


Elektor's friends at SparkFun Electronics are guest editing the next 
edition of Elektor Mag! We are excited to announce that our editorial 
and engineering teams are currently collaborating closely with engi- 
neers at SparkFun Electronics — a Colorado-USA based innovator of 
fun and interesting electronics kits and modules — on various amaz- 
ing electronics projects, articles, and engineering tutorials for the 
March/April edition. Below are just some of the articles and topics 
that we are working on: 


> Getting Started with MicroMod 

> Tips for Creating Custom Electronic Products 
> How to Build a DIY GNSS Reference Station 
> Programming an FPGA 

> DIY Circuit Board Organization 

> Must-Haves for Your Electronics Workspace 
> ClockClock: An FPGA Demo Project 

> Implementing FreeRTOS on RED-V 


And much more! 


Don't miss the upcoming special edition of Elektor Mag created by 
engineers and makers from Europe and America! 


Elektor Magazine edition 2/2021 (March & April) will be published 
in March 2021. Arrival of printed copies for Elektor Gold Members is 
subject to transport. Contents and article titles subject to change. 
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DIY LiPo 


Supercharger Bundle 


GreatScott and Elektor’s LiPo Charger, Booster, 


and Protector 


Need a rechargeable LiPo power supply for 5- and 12-V output? Want to practice SMD 
soldering? You can with a little help from GreatScott! (a YouTuber with 1+ million 
subscribers) and Elektor. In this article, we detail both the handy portable power supply and 
the obstacles we encountered during the development process. 


By Mathias Claufen (Elektor) 


upercharger Bu 


Biv LiPo Supe enti 





Figure 1: Boxed product. 


For experimenting with electronics we are used to our trusty power 
supplies on a lab bench. While this is the usual way to get prototypes 
up and running the leads sometimes become a bit of a handicap if 
the device we build is meant to be portable or moving around the lab. 
The workaround can be a bunch of batteries carefully crafted with 
duct tape, hot glue and some cheap DC/DC converter into a kind 
of portable battery pack. That works for a prototype, but it isn’t that 
nice, especially if you need 5 or 12 V for your device. This can be done 
in a better way and it has. After meeting at the 2019 productronica 
fair in Munich, Elektor and popular engineer GreatScott! decided to 
team up to develop a handy DIY kit just for you. 


Who is GreatScott? Great Scott! is the name of a Youtube channel [1] 
launched back in 2013 presenting electronic projects and knowledge 
to more than 1 million subscribers. The videos include a wide variety of 
DIY projects that viewers can recreate. Many other videos offer inspi- 
ration and clear solutions to engineering problems. As a few videos 
have already launched featuring Elektor products, the idea came up 
to present a DIY kit that everyone that is interested can use to expend 
their knowledge and skills. 
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GreatScott! [2] has sketched the raw schematic of a LiPo powered, 
rechargeable supply that shall be user buildable with SMD compo- 
nents. All the components and ingredients look not that complicated 
on first sight, a charging IC for LiPo batteries, a DC/DC converter 
to provide 5 V and 12 V and a battery protection IC. All components 
are chosen to be 1206 in size where possible, to allow even begin- 
ners to get all SMD components onto the PCB and hopefully show 
that soldering SMD is not a kind of black magic that only well trained 
wizards can do. Parts that need some kind of special attention are 
already built onto the PCB to make your start into SMD assembly even 
a bit easier and avoid dealing with small pins and pads underneath 
ICs. For charging you can use direct attached cables providing 5 V 
or use the USB-C connector on the add-on PCB to provide power 
to recharge the battery. With USB-C it is a lot easier to connect the 
plug in the right orientation and the connector on the PCB itself is 
held in place by four THT mounting holes for more stability. Besides 
using the power supply a fun part of the project is building it in the 
first place. And this comes with a nice step by step guide included in 
the package. Refer to Figure 1 for a first look. 








Figure 2: The three iterations from left to right. 


SPECIFICATIONS 


Input: 5V+/-10% 
Output: 5V /1.5 A or 12 V /0.75 A 
Single Cell Lithium battery 


The three ICs that make the board work are from a well-known vendor. 
The battery protection IC is a XB8089D from Xysemi, a chip only 
found at distributors that specialize in Chinese silicon products. This 
chip handles overcharge , over discharge, over current and reverse 
polarity protection in a small SOP8 package with expose pad for a 
reasonable price. While many batteries used in products like drones 
have integrated protection, it won't be safe to remove the chip from 
the circuit if a lithium battery without protection is installed. 


With the sketches and rough schematic GreatScott provided, Elektor 
added their experience in creating and designing PCBs. You might 
think this is the end of the story (you have a PCB and everything is 
fine), but as rule of thumb, it usually takes three iterations, as you can 
see at Figure 2. The first prototype worked almost as expected besides 
a few minor issues, like not charging the battery or disintegrating the 
DC/DC converter if load exceeded a certain point. The battery protec- 
tion IC will prevent the lithium battery form becoming damaged ( sort 
of ) but the current limit is at 10 A ( meaning 37 W ), so the DC/DC 
converter disintegrated at around 15W. And the charging, that was 
an easy fix, as there was somewhere a typo, making the desired 10 k 
resistor a 100k resistor, it was just a short swap of components. But 
to be honest, we know where to look when it comes to the wrong 
resistor for charging as we have seen this in other projects before. 


= WEB LINKS 


[1] GreatScott! Youtube channel: www.youtube.com/c/greatscottlab/ 
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Figure 3: Assembled PCB. 





Figure 4: PCB in action. 


The chosen BQ24092 comes from a BQ2409x line and this is where 
you need to check the datasheet carefully. Depending on the chip 
chosen the mentioned resistor needs to be 10 k or 100 k, and it was 
easier to change the resistor than the whole charger IC. There are more 
lessons learned as we did three iterations. How to fix the disintegrat- 
ing DC/DC converter is something that is quite simple if you know 
what parts you can choose. Also some do's and don'ts were made 
during the iterations and for manufacturing we may have also a few 
lessons learned you can benefit from. Meanwhile you can check out 
the Youtube channel of GreatScott! and see the assembly and the 
power supply in action. Details and an in-depth description of the 
circuitry will follow next time. The rough specifications are presented 
in the nearby textbox. The final revision of the PCB looks like what 
you see in Figure 3. Figure 4 shows it in action. M 

191188-01 





[2] GreatScott interview: www.elektormagazine.com/news/elektor-magazine-2020-summer-edition 
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MTheCam 


A Simple Mini Thermal Camera 


By Olaf Mertens (Germany) 


Did you blow the candle out? And was the hob turned off? Everyone has, at some point, 
experienced that nagging feeling after leaving the house that some heat source or other 
might still be on and poised to do untold damage. Now you can find out using MTheCam 

and your smartphone. The project described here is based on an eight-by-eight pixel thermal 
sensor from Panasonic that, naturally, has many other applications. 






When we say ‘hot spot’ we are, of course, not referring to public Internet 
access points. Instead we are referring to locations that are significantly 
warmer than their surrounding environment (and the opposite for ‘cold 
spots’). They can be symptomatic of a fire, overheating components 
or short circuits, thermal bridges, or broken seals allowing heat to 
escape. If they are not accompanied by a naked flame or glow then 
they are invisible to humans. To track them down the eye needs some 
assistance: enter MTheCam. 


Tracking down hot spots means much more than detecting a hotplate 
that has inadvertently been left on. In electronic circuits, overloaded 
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components will 
often give an early 
indication of their 
imminent demise 
by becoming 
hotter than usual; 
and, in machinery, 
worn bearings and inadequately lubricated 

surfaces will heat up, giving a timely warning that can help extend 
the life of the equipment. Even people can be detected, tracked and 
counted using a heat sensor. 
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Figure 1: Screenshot showing the eight-by-eight 
grid of pixels. 


As well as instruments that measure temperature by direct contact 
there are also contactless sensors that measure infrared radiation 
from objects, thus determining the average temperature in the field of 
view. This is done by using the pyroelectric effect where the electrical 
potential of electrodes in a polarised crystal change when exposed 
to thermal radiation. This effect can be exploited using electronics [1]. 


The project 

MTheCam takes measurements up to five times per second simul- 
taneously from 64 points arranged in eight rows of eight columns. 
Similar to an ordinary camera, these are arranged to have a 60° field 
of view. Each point can detect a temperature between 0°C and 80°C 
(or alternatively from -20°C to +100°C). The individual readings are 
displayed using a gradient of colour values, resulting in an image with 
very low resolution. This image can be served as a web page over 
a wireless network so that it can be displayed on a smartphone, for 
example. The gaudy but chunky image is certainly not reminiscent 
of HDTV but it does clearly display hot and cold spots in contrast- 
ing colours that distinguish them from surrounding objects. As well 
as this false-colour image, the temperature of each pixel is shown in 
degrees Celsius, allowing for a more precise analysis (see Figure 1). 


Furthermore, the 64 readings can also be requested in JSON format, 
making it easy to share the information with other applications. 


A little bit of mathematics lets us give the illusion of a higher resolu- 
tion than provided the 8-by-8 pixel matrix. Bicubic interpolation [2] is 
used to create a ‘fake’ 32-by-32 pixel image that not only looks more 


Figure 2: Screenshot showing values 
interpolated in a 32-by-32 grid. 








Figure 3: The Panasonic AMG88xx sensor. 


attractive, it also makes it easier to recognise objects in the image. The 
range of the false colour gradient is also extended somewhat beyond 
the minimum and maximum temperature values, acting like a magni- 
fying glass over the temperature readings (Figure 2). 


The AMG88xx thermal sensor 

To capture thermal images, Panasonic has developed a powerful 
thermal MEMS (Figure 3) available in two variants covering different 
temperature ranges. The very tiny package includes the optics, the 
thermoelectric transducers, analogue-to-digital conversion and signal 
conditioning [3]. The AMG8853 covers the range from 0°C to 80°C 
while the AMG8854 covers -20°C to +100°C, with maximum error 
specifications of +2.5 K and +3 K respectively. Both are accessed 
over an l2C bus. The absolute accuracy is not outstanding, but the 
device is nevertheless perfectly good for qualitative assessment of 
relative values. 


With a couple of lines of software it is possible to calibrate the readings 
from the device that increase the accuracy of the results and reduce 
noise. The sensor is available in a space-saving SMD package that is 
designed for reflow soldering. For our application we use it mounted on 
a small, home-made breakout board that also includes a few passive 
components (in easily hand-solderable 0805 packages) required for 
decoupling the power supply and pulling up the 12C bus lines. Pads on 
the edge of the board carry the +5 V and GND power supply pins as 
well as the three signal lines required (INT and the I2C bus). This allows 
a straight or right-angled pin header to be fitted. Figure 4 shows the 
circuit diagram of the breakout board and, for interest's sake, a little 
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Figure 4: Circuit of the AMG88xx sensor breakout board showing its internal architecture. 


of the internal circuitry of the sensor. The free download accompa- 
nying this project [9] includes layouts of the two layers of the board 
and the component-mounting plan. Those in search of an easy life 
can purchase a ready-made module from the author. 


M5StickC, the Jack of all trades 

Any smartphone with a WiFi interface and a touch screen for input 
and output makes a perfect user interface for MTheCam. In order to 
use the WiFi interface to communicate with the sensor we equip it 
with a ‘smart’ data transmitter comprising of an SoC (system on a 
chip) with a microcontroller and a WiFi peripheral. 


We decided to use an Espressif ESP32 [4]. This module includes every- 
thing a developer's heart could wish for and it is inexpensive and 
power-efficient. Moreover, it supported by the Arduino ecosystem. The 
only electronics needed besides the sensor and the ESP module is a 
5 V power supply, either from USB or, for mobile use, from a recharge- 
able battery. Looking in the Elektor Store our eyes fell upon a product 
in a dazzling shade of orange that includes an ESP32 and some other 
interesting components, the M5StickC [5], which is perfect for the job. 


The M5StickC crams rather a lot into its tiny 50 mm by 26 mm by 14mm 
enclosure. It contains an ESP32-Pico with 4 MB of flash and 520 kB of 
SRAM, an 80-by-160 pixel 0.96 inch display, a six-axis motion sensor, 
a real-time clock, a power management unit, a red LED, an infrared 
LED to allow it to be used as a remote control, a MEMS microphone, 
an 80 mAh rechargeable battery, a USB-C port, a Grove connector 
(power, ground and two 12C ports) and an 8-way header with three 
ports and power supply — enough to make even the most jaded 
engineer sit up and pay attention! 


The small dimensions, display and rechargeable power source mean 
that the M5StickC can be used as a rather natty smart watch, for which 
a suitably garish strap and mount is included. It certainly makes a 
fashion statement as Figure 5 shows! Who needs the boring products 
of a certain Californian fruit company to which you can't even plug 
anything in? 
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For our project we need only the ESP32, the display and the recharge- 
able battery. The other features are still there, of course, and will no 
doubt find a use in other applications. 


The display on the M5StickC is small but it shows a sharp and colourful 
image. User interface designers will be challenged to display informa- 
tion within the small area available. The thermal sensor image works 
well on the display and we have a couple of lines available to show 
readings as text. The display driver library allows plenty of scope for 
fancy graphics, animations and festivals of light and colour: let your 
imagination run riot! 


The 80 mAh lithium-ion battery can power the M5StickC running flat 
out for around an hour. It is charged over a USB-C connector at 5 V 
and 500 mA using the cable supplied connected to a standard USB-A 
socket. A small button on the side turns the device on, while holding 
the button down for six seconds turns it off. 


Cooperation 

The sensor breakout board is plugged into the external expansion 
connector. It can be connected either flat on its back using a right-an- 
gled header, or using a straight header to make measurements along 
an axis parallel to the longest edge of the device. This allows it to be 
‘fired’ at its target (Figure 6). Any 3D-printing wizard should be able 
to quickly whip up a neat enclosure for either configuration. 


The M5StickC expansion connector has eight connections. We only 
use the 5 V output, ground, the two 12C pins carrying data and clock 
signals (SDA on GPIO26 and SCL on GPIOO), and the INT inter- 
rupt signal that we connect to GPIO36. The BAT, 3V3 and 5 V input 
connections are unused. Note that GPIO36 can only be used as an 
input, a little piece of information that might save you a while in track- 
ing down any problems. 


Currently, the interrupt feature is not implemented in the software. The 
sensor chip is able to generate an INT signal when a specified minimum 
or maximum temperature threshold is exceeded. In fact, this can be 





configured for each pixel. Thus the chip can autonomously monitor a 
particular point in its field of view and only wake up the ESP32 when 
its temperature exceeds a threshold, thereby saving power. A similar 
monitoring feature could also be implemented in the smartphone app, 
taking into account all the pixels in the image. 


A matter of software 

To create the firmware it is possible to use either Espressif’s proprietary 
development environment or the Arduino ecosystem. The latter is very 
easy to use as there is a highly-effective global community support 
network. The original Arduino IDE is a good way to get started, but 
it is not really up to the task of building more advanced applications. 
Instead, the author recommends the free Visual Studio Code editor 
from Microsoft that supports Arduino via an extension [6]. M5Stick-C 
(esp32) can be found under the Board Manager. 


The firmware for MTheCam was developed by the author using C++. 
Besides the Arduino source code MTheCam_LT.ino and a couple of 
.h and .cpp files (Mxxx.cpp/h) we also use the highly-recommended 
ArduinoJson library for JSON handling (version 6 of this library is 
required; version 5 will not work). The hardware of the platform are 
comfortably supported by the M5StickC library [8]. This must be 
installed using the library manager (F1 - Arduino: Library Manager). 


While the ArduinoJson library documentation is a pleasure to read, this 
cannot be said of the descriptions of the M5StickC library. To use it 
successfully requires the source code to be tediously and painstakingly 
examined and is rather too much like work and not enough like play! 


We will now look at various snippets of code covering the various 
functions in their logical sequence. 


Sensor read 

Readings are made available in byte-wide registers in the sensor ten 
times per second. The software continuously reads these registers 
over the 12C bus using the Wire library. The pixel data has a resolution 
of 12 bits and so two bytes are used for each. Thus the code to read 
the registers in MTC_readReg() appears as follows. 


#define BUF_LENRX 128 
int reg = 0x80; 
byte _rxBuf[BUF_LENRX] ; 


Wire.beginTransmission(devAddr); // chip address: see 
datasheet 

Wire.write(reg); // 0x80 -> read 128bytes of 64 
pixels @ 12bits 

Wire.endTransmission() ; 

if (Wire.readTransmission(devAddr, rxBuf, BUF_ 
LENRX) == I2C_ERROR_OK) { success = true; } 

Wire.endTransmission() ; 


Under some circumstances, Wire. readTransmission() can return 
an error code that can come in useful when tracking down bugs in 
the read process. 


The code excerpt shown in Listing 1 is responsible for reading the 
sensor and calculating temperature values. With the help of a little 
bit-twiddling, two entries in the rxBuf[] array are converted into a 
temperature represented as an integer in units of one-hundredth of 








Figure 5: The M5StickC as a bright orange smartwatch. (Source: mdstack. 
com) 
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Figure 6: Right-angled or straight — there are two ways the sensor can be 
mounted on the M5StickC. 


a degree Celsius. This means a temperature of 21.35°C is represented 
as 2135. The sensor is initialised so that, internally, it performs a moving 
average of two consecutive frames, thus yielding a significant amount 
of noise reduction. The registers are read out in a single pass that 
guarantees all the values belong to the same frame. The calculations for 
the pixel temperature and the on-chip thermistor temperature (which 
we do not use here) differ (see the datasheet [3] for more details). For 
improved accuracy in the calculation, intermediate values are repre- 
sented in units of 1/10,000 of a degree, with a subsequent division 
by 100 to produce final results represented in hundredths of a degree. 


Calculating the colour value 

The colour display is implemented using the HSL colour model [10] 
(Figure 7) and the M5StickC bundle includes a suitable TFT driver 
library. Of the three parameters hue (H), saturation (S) and luminance (L) 
we only vary the H parameter, or angle, in the colour wheel. The S 
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Listing 1: Reading the sensor and calculating the temperature. 


// read one frame with 64 temp-values a 12bit -> join 2 bytes to 1 int 
// result is int[] with calculated values -> _frame[] 
int _frame[FRAMESIZE]; // filled by MTC_getFrame() 


int» MTC_getFrame() 


{ 
byte _rxBuf[BUF_LENRX] ; 
byte dL[FRAME_SIZE]; // low byte 
byte dH[FRAME_SIZE]; // high byte 
int reg = 0x80; // start with this reg for next 128 bytes to read 
// sensor-read 128 bytes - low + high 
boolean ok = MTC_readReg(MTCADDRESS, reg, _rxBuf, 128); // readings now in _rxBuf 
if (ok) 
{ 
int k = 0; 
for (int a = @3) a < FRAME_SIZE;; +4) 
{ 
int index = i; 
int dl = _rxBuf [k++]; // low byte here 
int d2 = _rxBuf [k++]; // high byte next: includes sign! 
// sensor on PCB is upside down, start from the end 
index = (FRAME_SIZE - i - 1); 
_frame[lindex] = MTC_calcTemp(d1, d2); // 2 bytes calc’d to one int 
} 
} 
return _frame; 
} 
// make one int from low/hight bytes d1/d2 
int MTC_calcTemp(uint8_t dl, uint8_t d2) // return temp in deg Celsius * 100 
{ 
int factor = (int) (0.25 * 10000); // pixel-temp, for device-temp use 0.0625 
if (d2 & 0b00001000) d2 |= 0b11111000; // handle sign-bit #4 in high-byte 
int valRaw = (d2 << 8) | dl; // merge to one int .. 


int valCalc = (int)(valRaw + factor / 100); // « with this factor 
return valCalc; 


Listing 2: Calculating colour values. 


#define MC_COLORWHEEL_LOW 315 // degrees on colorwheel 
#define MC_COLORWHEEL_HIGH 15 
#define MC_DIFFCW 60 // diff in degrees high to low 


int MC_getColorHSL(int value, int vmin, int vmax, int vavg) 


{ 
// do not use 255 - 315 deg = 60 deg -> it’s not clearly ‘felt’ as cold or hot 
// vmin/vmax for minimum spread of spectrum -> less color flicker if no spots seen 
if((vavg - vmin) < MC_TMIN_SPREAD2AVG) { vmin = vavg-MC_TMIN_SPREAD2AVG;3 } 
if((vmax - vavg) < MC_TMIN_SPREAD2AVG) { vmax = vavg+MC_TMIN_SPREAD2AVG;3 } 
// map range vmin -> 315, vmax -> 15 degree ‘left turn’ - exclude 315...15 = 60 deg 
int colInd = map(value, vmin, vmax, MC_COLORWHEEL_LOW, MC_COLORWHEEL_HIGH); // 315/15 
colInd = colInd - MC_DIFFCW; // turn - 60: icecold->DEEPBLUE=255, hot->DARKRED=315 
if (colInd < 0) colInd += 360; // no neg. values! 
return colInd; 

} 


12 January & February 2021 www.elektormagazine.com 








Figure 7: The HSL colour wheel and the sector used for our display. 


and L parameters remain constant. The HSL value is then converted 
to RGB for output on the display. 


The numerical values corresponding to temperatures from 0°C to 80°C 
ranging from 0 to 8000 in steps of one-hundredth of a degree. We want 
to normalise these to hue angles to values between 0 and 359. Since 
the colour blue is naturally associated with cold and red with hot, it 
seems that the sector of the colour wheel from 255° (a blue-green for 
minimum temperature) to anticlockwise 315° (a dark red for maximum 
temperature) would be ideal for the display. Shades of purple are not 
generally associated with temperature, so we avoid using this sector of 
the wheel. Of the possible 360 colour values we use 300 and skip 60. 


The handy map () function used in Listing 2 first converts the tempera- 
ture value into an angle in the 300° sector of the colour wheel anticlock- 
wise from 315° to 15°. It then rotates this angle anticlockwise by 60° 
in order to reach the desired range from 255° anticlockwise to 315°. 
In order to reduce the rather high apparent noise level in areas of 
constant temperature without hot or cold spots, a minimum offset 
between both the minimum temperature and the maximum tempera- 
ture relative to the average temperature of 500 units is enforced. This 
means that the displayed colour range (the ‘magnifying glass’) has a 
minimum range of 1,000 units, or 10 K. If this range were allowed to 
become very small then tiny changes in the readings would show up 
as violent changes in colour. 


Apart from thi,s the full range of colours is always used to represent 
the temperatures in the image. 255° on the colour wheel represents 
the minimum temperature, running round (anticlockwise, don't forget!) 
to 315° for the maximum temperature. 


Presentation on the display 

In order to implement the magnifying glass function that converts the 
actual range of readings to the available range of colours, the colour 
conversion function takes the values tminRange and tmaxRange as 
parameters (Figure 8). This only gives a relatively crude level of control 
over the colours used in the display. A specialised algorithm could be 
implemented to make the magnifying glass function more sophisticated. 
This could adaptively adjust the range values over multiple consec- 


Magnifying glass on the spectral range for better representation 


Range °Celsius 
--20----22----24----26----28----30-- 





Color spectrum of the entire sensor range (°C) 


Figure 8: The range of measurements is stretched to cover the spectrum of 
available colours. 





Figure 9: Thermal image as displayed on the first prototype. 


utive readings to avoid jumps in the colour mapping. Alternatively, 
it could handle the dynamics of the manner in which hot spots and 
the background are separately displayed to bring the hot spots out 
more clearly. There is plenty of scope for experts in machine learning 
to deploy Al algorithms for pattern recognition, noise reduction and 
data analysis. 


As Figure 9 shows, the TFT display on the M5StickC shows the origi- 
nal thermal image with the colour map that is used in the upper half of 
the screen, while below the readings for the minimum and maximum 
temperatures over all the pixels of the image (tMin and tMax) are 
shown, as well as the calculated average value. These are shown in 
hundredths of a degree (without a decimal point). 


WiFi and server 

So far everything has been running locally on the M5StickC without 
any external connection. However, if we want to show the results on 
a remote portable device or process the readings further, we need to 
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Listing 3: WiFi and web server. 


const char xssid = “YourSSIDHere” ; // change... 
const char xpassword = “YourPasswordHere”; // .. to your WLAN 
WebServer webServer (80) ; // listening on port 80 = standard 
WiFi.mode(WIFI_STA) ; // switch to ESP station mode 
WiFi.begin(ssid, password) ; // Look for known WLAN & try to connect 
while (WiFi.status() != WL_CONNECTED) // wait for connection 
{ 

delay (500) ; // 500ms delay 

Serial.print(“.”); // still alive 
} 


Serial.println(“\n[Setup] WIFI connected!”) ; 
// what to do if browser request is coming in 


webServer.on(“/”, MW_index) ; // call MW_index() for / or /index.html 


webServer.on(“/index.html”, MwW_index) ; 


webServer.on(“/frame”, MW_frameJS) ; // /frame - output as JSON-Data 


webServer.onNotFound (MW_notFound) ; 


webServer.begin() ; // webserver starts here 


// Webserver callback 
void MW_index() 
{ 


// send HTML-Doc from literally defined PROGMEM var 


webServer.send_P(200, “text/html”, _uidoc); // send_P: use PROGMEM-Var 


// main loop 
void loop() 
{ 


// give webserver a chance to handle requests. No delay() in LOOP! 


webServer.handleClient() ; 


connect the M5StickC to a wireless network and set it up as a web server. 


The Arduino software includes the libraries WiFi.h and WifiClient.h 
that implement just such a web server. All it needs as parameters are 
the access details for the network's SSID and password. After reset, or 
a power cycle, the display will show that the device is trying to connect 
to the network. If this is successful it will show the IP address to which 
it has been assigned. If unsuccessful, it is necessary to verify that the 
access details are correct and that the access point is in range. The 
range of the device is surprisingly good and it can certainly hold its 
own against smartphones in this respect. 


The web server then sits waiting for requests on the local IP address 
assigned to it by the router for the pages /, /index.html and /frame. 
For example, it might respond to http: //192.168.10.1/. 


Once we have set up the WiFi connection we need to tell the web 
server what to do when it receives a request from a client browser. A 
corresponding function will be called so that, for example, a request for 
/ (or equivalently for /index.htm1) will result in a call to Mw_index() 
that, in turn, delivers a document to the client: 


webServer.send_P(200, “text/html”, _uidoc) ; 


send_P is used because the HTML document _uidoc is stored in the 
flash memory as PROGMEM in order to reduce RAM usage. Commented 
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excerpts from the WiFi and web server code are given in Listing 3. 
MTheCam can display colourful thermal images on any smartphone. 


HTML and JSON 

Request for the pages / and /index.html generate a web page 
with an eight-by-eight grid of colour patches with the temperature 
values superimposed on them. The page also contains the minimum, 
maximum and average temperature values (tmin, tmax and tavg 
respectively) over the frame. Different colours represent different 
temperatures over the range tminrange to tmaxrange, with these 
limits computed dynamically as described above. The ‘Image’ button 
switches the display to a ‘high-resolution’ false colour mode with 
interpolated values, and the ‘Values’ button returns to the original 
mode. By default a new image is displayed every second. This period 
can be adjusted using a slider. The ‘Grid’ check box overlays a grid 
on the image. 


A request for the page / frame delivers the temperature values in 
JSON format so that they can be processed further by another appli- 
cation. It is best to leave at least a 200 ms delay between requests as 
the sensor chip requires around 100 ms to take a set of readings. If 
push had come to shove the JSON object could have been created 
using ordinary string manipulation functions, but there is a very 
convenient library called ArduinoJson.h that makes things much 
neater. This library can also read JSON objects. A typical object 
might appear as follows. 


Listing 4: Creating an HTML document containing the measured values. 


/* Canvas-Area 400 px with 8*8/32*32 tiles a 50/12 px */ 
<div class=”row”> 
<div class=”coLlumn”> 
<canvas id=”canvas”></canvas> /* size see resizeCanvas() */ 
</div> 
</div> 


/* resize canvas for value or image mode x/ 
function resizeCanvas () { 


canvasSize = rectSize x gridSize /* gridSize: 8 or 32 @rectSize: 12 or 50 x/ 
canvas.width = canvasSize 
canvas.height = canvasSize 


/*x update image, rate = 200..3000 ms x/ 
function refresh (rate 1000) { 


refresher = setTimeout(function () { 
getData() 
}, rate) 


/* request temperature-frame from MTC via /frame - call x/ 
function getData () { 
fetch(url) 
.then(response => response.json()) 
.then(jsonData => { 
if (mode == 1) { 
// tempvalues, colors (interpolated) in framecolinter array 
paint(jsonData.frame, jsonData.framecolinter) ; 
} else { 
// tempvalues, colors (original) in framecol array 
paint(jsonData.frame, jsonData.framecol) 


} 
infoText(jsonData) /* show min/max etc. values */ 
}).catch(err => { 
errorText.innerHTML = ‘Error: $?’ 
}).then(function () { 
refresh() /* start timer for next ride */ 


n 


/* paint tiles on canvas */ 
const ctx = canvas.getContext (“2d”) 


function paint(values, colors) { 


ctx.clearRect(0, 0, canvas.width, canvas.height) ; 
colors.foreach(color, index) m. { 
: /* set x/y of next tile: x+=rectSize .. x/ 
/* paint tile x*/ 
ctx.beginPath() 


ctx.rect(x, y, rectSize, rectSize) /* paint square */ 

ctx. fillStyle = ‘hsl($, 100%, 50%)’ /* set color of square x/ 

if (grid) { ctx.stroke() } /* show grid optional */ 
etx. tT LLC) /x do fill x/ 
ctx.closePath() 

if (mode == 0) { /*x values as text over */ 


// show tempvalues @mode=0 -> lowres 8*8 only 
drawText(values[index], x + 7, y + rectSize / 2) 


} } 
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{“device”: “MTheCam”,”ver”: “1.0”,”rowsize”: 
8, "batvolt” i 3:39; 

“tav”: 2317,"tmin”: 2050,” tmax”: 2750,” tminrange” : 
1817,”tmaxrange”: 2817, 

“frame”: [2075, 2050, 2100, 2275, 2600, 2475, 2100, 
2050, , ]} // 64 values °C * 100 // + 2 
arrays with ‘HSL’ colours of 8x8 and 32*32 tiles. 


Listing 4 shows the most relevant part of the HTML code. The body 
of the document, including all the CSS and HTML tags, is defined as 
a fixed string and is sent to the client, whereas the thermal image is 
implemented as an HTML canvas comprising tiles in an 8-by-8 or 
32-by-32 grid in value mode and image mode respectively. 


A script in the HTML code periodically requests the sensor data from 
/ frame under control of a timer, obtaining a JSON object as above. 
JavaScript and JSON work well together and it is easy to extract the 
payload data from the object. jsonData. frame and jsonData. 
framecol yield arrays that represent the readings and colour values 
directly. From these we can extract the original temperature values 
and the interpolated colours, then set the colours of the tiles and the 
overlaid numbers appropriately. The display update interval can be 
adjusted from 200 ms to 3 s. 


= RELATED PRODUCTS 


> M5StickC 


www.elektor.com/m5stack-m5stickc-esp32-pico-mini-iot-development-board 


Questions or Comments? 

Questions or comments regarding this article? Send an e-mail 
to the author (mtc@micom.de) or to the editor 
(editor@elektor.com). 


= WEB LINKS 


[1] 
[2] 
[3] 
[4] 
[5] 
[6] 
[7] 
[8] 
[9] 
[10] 


Pyrometer: https://en.wikipedia.org/wiki/Pyrometer 


AMG88xx: https://bit.ly/2VPiCGc 

ESP32 documentation: https://bit.ly/37FIlcEk 

M5StickC: https://bit.ly/2In5aqQ 

Visual Studio: https://code.visualstudio.com/ 

ArduinoJSON : https://arduinojson.org/ 

M5StickC library: https://github.com/m5stack/M5StickC 
Author's project page: https://www.micom.de/lab/mthecam 
HSL colour model: https://en.wikipedia.org/wiki/HSL_and_HSV 
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A good basis for further projects 

There is plenty of scope for expanding the firmware. For example, the 
ESP32 could be configured as an access point so that it can deliver data 
directly over WiFi rather than requiring an external wireless network. 
Provision could be made for entering the access details for other WiFi 
networks more conveniently. The colours used for the display and 
magnifying glass could be made configurable, and filters could be 
designed to reduce noise and flicker. An Android app could handle 
multiple MTheCam devices simultaneously, displaying all their images 
in a live view. Alarm conditions could be specified, with automatic notifi- 
cations sent out. This could be done relatively simply using Node-RED 
and MQTT. It will be worth taking a look at the project web page from 
time to time [9] as the foundation for some clever and useful appli- 
cations is already there! 


The author would like to extend a special thanks to Daniel Zelosko for 
developing the prototype. Id 
180337-02 
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Weller WE 1010- 
Soldering Station 


By Harry Baggen (Elektor) 


The choice of 
soldering irons 

and soldering 
stations is enormous 
but, for many electronics 
enthusiasts, the name Weller 
will immediately spring to 
mind. Weller’s soldering 
stations are widely used 
and the prices are not 
bad. In this review we look at the cheapest soldering station in the professional series, 
the WE 1010. With its price of just over €150/£130/8170, this station is also of interest to 
the serious hobbyist. 






My first Weller was a WTCP soldering station with the famous 
Magnastat soldering iron. The temperature was controlled by a 
magnet in the tip that lost its magnetic attraction above a certain 
temperature (Curie effect). The tips were for sale for different 
temperatures so you could ‘set’ a certain temperature. My Weller 
(Figure 1) has 10-1978 as the production date on the nameplate, so 
it is more than 40 years old, but it still works very well. Now that 
I'm doing some more electronics work at home I thought it was 
time to buy a more modern soldering station. I wanted one with 
a display that shows the temperature and an iron that is a little 
easier to handle than the old Magnastat. 





These days you can buy very nice soldering stations, mostly made 
in China, for a modest outlay. But I also took a look at the Weller 
options to see if I could buy something there for not too much 
money. In addition to a few hobby stations Weller has a basic version 
in its Professional series for around €150, which was what I had 
budgeted for a new soldering station. The advantages of sucha 
Weller version over Chinese alternatives: reliability (hopefully), 
long-term support and a very flexible and heat resistant cable to 
the soldering iron. I hope that, with such a new soldering station, 
TIl be using this one for a number of years too. Figure 1: My old Weller soldering station is over 40 years old and still works! 
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Figure 2: The display shows the temperature of the tip and, below that, the 
set value. 


Purchased 

So the decision fell for the WE 1010 consisting of a base station with 
LCD display and a soldering iron with a power of 70 W. Although 
this is a soldering iron with passive temperature control (heating 
and sensor are not in the tip itself but behind it) I don’t think it is 
an issue (more on this later). The box contains a base station with 
matching power cord, a WEP 70 soldering iron, a fairly simple stand 
consisting of a moulded base with a holder that is inserted into it, 
and a sponge. It all looks rather ordinary but everything is neatly 
finished. On the station there is an on/off button, an LCD and some 
control buttons (Figure 2). 








Unfortunately, the display is not backlit. However, it is very clear 
and easy to read, even with little ambient light. Alas the power 
switch has no built-in lighting either. Thus you can only see that 
the station is on because something is visible on the display and 
the power switch, in the on position, shows a red line. 


The base station is quite heavy (almost 2 kg) and feels solid. The 
1.5 m long cord (with silicone sheath) on the soldering iron is very 
supple and it lies well in the hand with its covering ofa kind of 
pressed foam. The cable of the soldering iron has a 5-pole plug at 
the end which is inserted into the socket on the base station, then 
locked by turning. The metal part of the soldering iron is connected 
to the earthed socket of the mains cable. There is no separate earth 
connection on the station. 


Operation and use 

The operation of the soldering station is kept very simple. With 
the up and down buttons the temperature can be set higher or 
lower. On delivery it is preset to 350°C. There is also a menu key 
with which you can access the following settings: standby time, 
the time after which the soldering iron is switched back to a lower 
temperature (max. 99 minutes); offset, for temperature correc- 
tion and only useful if you can measure the temperature of the tip 
(max. +40°C); switching between °C and °F; and finally the abilty 
to set alock code. 
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Figure 3: You can easily change a tip by unscrewing the metal sleeve. 


The display shows the current temperature of the soldering tip in 
large digits and below that the set target value in smaller digits. 
In addition to the target value, a heating symbol appears when 
the iron is heating up. Even when the standby function is active 
or when the lock-out function is used, the corresponding symbols 
are still displayed. 





Due to its weight the soldering iron holder stands well on the table. 
It has a number of holes to accommodate spare tips. To wipe the 
tip clean there is, of course, the customary yellow sponge. There 
is no room for brass wool or the like. If you prefer using sucha 
bundle of metal wool to wipe the tip you'll have to buy an extra 
container with metal wool. 


The soldering iron itself is quite slim and the flexible cable is nice 
and long. It is also so flexible that you hardly notice it when solder- 
ing. The soldering tips can be changed simply by unscrewing the 
metal sleeve of the front part using a plastic nut (Figure 3). It is 
because the tip is indirectly heated, as already mentioned, that 
replacement tips are very inexpensive — even the original 
ones from Weller. They are available almost everywhere 
and I have already bought some with other tip 
shapes (Figure 4). 


Lighting up! 

After switching on it took around 35 seconds until the soldering 
tip had reached a temperature of 350°C. The 380°C needed for 
lead-free solder needed around 5 seconds more. Soldering with 
the WE P70 soldering iron works smoothly. There are no problems 
when soldering average components and standard copper pads. 
With large soldering surfaces you will notice that the temperature 
drops a bit and the tip needs a few seconds to reach the set point 
again (an active soldering iron reacts much faster in such cases), 
but this only takes a short time thanks to its 70 W heating power. 
In such cases it is advisable to use a short soldering tip with a large, 
bevelled tip so that the heat can be transferred more optimally. 
The tip supplied is rather too narrow for this and is better suited 
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Figure 4: I have already bought some extra soldering tips. 


to soldering small components. 

To implement the standby function the station monitors how 
much heat is supplied to the iron rather than using a motion 
detector in the soldering iron. If the heat output remains steady 
for a certain time (standby setting), the temperature is automat- 
ically reduced to 180°C (Figure 5). 


The tip temperature is automatically raised again if a lot of heat is 
removed from the tip, such as by sliding it over 
the wet sponge. A more direct method is to 
briefly press one of the buttons on the 
base station. For me the longer 
standby times are better and 


30 minutes is just right. Alternatively, you can switch the standby 
mode off completely. So far I have not noticed any scaling of the 
tips. Should this ever happen, the tips are inexpensive enough to 
replace. 


Conclusion 

Tam very satisfied with the WE 1010 as the successor to my old 
Weller soldering station. The soldering iron lies comfortably 
in the hand and the soldering is good. The adjustment options 
on the base station are limited, but sufficient for normal use. 
What I am missing is a better optical power-on indicator, as 
you have to look at the display or search for the red line on the 
power switch. Would an illuminated power switch or an extra 
ED really have cost that much more? It would have been worth 


= 








Figure 5: If the soldering iron is not used for a certain period of time, the 
station automatically switches to 180°C. 


alot to me. And the standby function? It’s not ideal, but you 
can live with it. In spite of these minor shortcomings I would 
definitely buy the WE 1010 again as it is a quality soldering 
station at this price point. M 


200572-04 











Questions or Comments? 
Do you have questions or comments about this article? 
Contact Elektor at editor@elektor.com. 
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RELATED PRODUCTS 


> Weller WE 1010 Digital Soldering Station (70 W) 
www.elektor.com/18513 


(@lektor January & February 2021 19 





VIRTOAL 
ELECTRONICA 
FAST FORWARD 


electronica 
y fast forward 


the startup platform 


powered by elektor 


By Clemens Valens (Elektor) 


electronica Fast Forward, the start-up 
competition powered by Elektor, went 
virtual in 2020. From January through 
October 2020, young electronics-focused 
companies from around the world 
presented their elevator pitches, business 
plans, and products. We congratulate all 
the talented participants. Here are the 
winners. 


Over the past few years, Elektor has organized the Fast Forward 
start-up competition, which has coincided with the electronica and 
productronica trade shows. But in 2020, things were a bit differ- 
ent, and you all know why. Instead of cancelling the event, Elektor 
and electronica (https://electronica.de/) moved electronica fast 
forward (e-ffwd) online, where companies from countries such as 
Germany, the United States, Hungary, and France (to name only a 
few) presented their elevator pitches, business plans, and products. 





Even though the e-ffwd competition was open to any start-up 
company, not all were admitted to the final round. Only the parti- 
cipants who submitted a business plan, a company profile, and 
a short video were presented to the jury. The videos replaced the 
elevator pitches that participants would normally deliver live in 
Coronavirus-free times in front of an audience and a jury. The 
live audience was simulated by public voting as visitors of the 
start-up profiles could rate them by giving stars. 
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electronica Fast Forward Winners 

After reviewing the various start-ups and their technologies, the 
official e-ffwd jury — headed by Professor Rik De Doncker (RWTH 
Aachen University, see inset) together with Elektor engineering 
and editorial representatives — selected the top three winners 
based on their high commercial potential and the quality of the 
team, two important criteria for a start-up to grow into a success- 
ful business. Congratulations to AXS Motionsystem [1], Micro- 
pack3D [2], and e-Fásli [3]! 











First Prize: AXS Motionsystem Ltd (Hungary) 

Founded in 2014, AXS Motionsystem Ltd develops an ergonomic 
expert system to evaluate and qualify workplaces. AXS System 
digitally captures the motion and hand-forces of a worker during 
the workflow. Based on the recorded data, the evaluation is done 
almost completely automatically according to different ergonomics 
methods. For its achievement, AXS Motionsystem won a €75,000 
Elektor marketing budget anda starter booth at electronica 2022. 


Second Prize: Micropack-3D (Germany) 

Micropack-3D is a recently founded start-up that develops adaptive 
electronic packaging — that is, the housing and connecting of 
integrated circuits (ICs). Its aim is to enable new generations of 
highly adapted and specialized electronics and shorten precious 
development time. The company won a €50,000 Elektor market- 
ing budget for Second Prize. 




















Third Prize: e-Fasli Ltd (Hungary) 

e-Fasli is the first self-learning heat therapy device. It can be 
attached to the body and can maintain a level of temperature 
between 25°C and 45°C for hours. Patient and disease data are 
gathered by a mobile app and then anonymous data is sent to 









First-prize winner AXS 
Motionsystem develops 
an ergonomic expert 
system to evaluate and 
qualify workplaces. 


he 


DESIGN FREEDOM FOR CONNECTING 


FREE PLACEMENT OF SHAPE AND SIZE. COMPONENTS WITH LOW 


ELECTRONIC INTEGRATION OF TEMPERATURE 
COMPONENTS. MICROCHANNELS, METALLIZATION AND 
TRENCHES AND CAVITIES. STRUCTURING. 


Runner-up Micropack3D offers innovative 
packaging options for electronic circuits. 


the server processed to determine the optimal and personalized 
therapeutic parameters. Then the device is controlled accord- 
ingly via a WiFi network. For its achievement, e-Fasli Ltd won a 
€25,000 Elektor marketing budget. 


See You Next Year? 
The virtual the electronica Fast Forward 2020 competition [4] 
was a success thanks to its wide field of high-level participants. 
Visit the e-ffwd page (www.elektormagazine.com /effwd-2020) to 
learn about all of the finalists. The technologies included: 





> Wireless charging 

> Edge computing 

> Electric vehicles 

> Energy harvesting 

> MEMS mirror and laser 
scanning solutions 


> Actuator technologies 

> Real-time control and 
monitoring 

> And mote... 


Hopefully, things will be back to normal soon, and we'll see you 
atthenextevent! M 
200584-01 


= WEB LINKS 
[1] AXS Motionsystem Ltd: 
www.elektormagazine.com/labs/axs-motionsystem-lItd 


[2] MicroPack3D: 
www.elektormagazine.com/labs/micropack3d 





[3] e-Fasli Ltd: www.elektormagazine.com/labs/e-fasli-ltd 


[4] e-ffwd 2020 Participant Profiles: 
http://www.elektormagazine.com/effwd-2020 









A rendering of the fourth prototype of 
e-Fásli's self-learning heat therapy device. 


Professor De Doncker 


The virtual Fast Forward Award 
jury was headed by Professor 
Rik W. De Doncker from RWTH 
Aachen University. 


Rik W. De Doncker (M'87 
SM’99 F'01) received in 1981 
his Diploma in Electrical- 
Mechanical Engineering and 
in 1986 his Ph.D. degree in 
electrical engineering from the 
KULeuven, Belgium. In 1987, 
he was appointed Visiting 
Associate Professor at the 
University of Wisconsin, Madison. In 1988, he joined the GE 
Corporate Research and Development Center, Schenectady, 
NY. In November 1994, he joined Silicon Power Corporation 
(formerly GE-SPCO) as Vice President Technology, 
developing world's first medium-voltage static transfer 
switch. Since October 1996, he is professor at RWTH Aachen 
University, Germany, where he leads the Institute for Power 
Electronics and Electrical Drives (ISEA). In October 2006, he 
was appointed director of the E.ON Energy Research Center 
at RWTH Aachen University, where he also founded the 
Institute for Power Generation and Storage Systems (PGS). 
He is director of the RWTH CAMPUS Cluster Sustainable 
Energy and leads the German Federal Government BMBF 
Flexible Electrical Networks (FEN) Research CAMPUS. He 
has a doctor honoris causa degree of TU Riga, Latvia. 
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I2S Test Signal Generator 
with AVR Microcontroller 


32-Bit 1-kHz Digital Sine, f, 192 kHz, 
Level Adjustable from 0 to -110 dB 
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By Ton Giesberts (Elektor) 





When you are testing or repairing an 
audio DAC with — for some reason — the 
analog audio output signal missing or 
being distorted and it is uncertain ifthe 
signal source has a problem (software and/ 
or hardware) or the DAC circuit itself is 
having an issue, this project can provide 
the answer. Its highly accurate digital sine 
wave test signal is also ideal to measure 
the analog performance of the DAC. 
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PROJECT DECODER 


Tags 
Digital audio, Raspberry Pi, DAC, 12S 
Level 

intermediate level 
Time 
About 4 hours 


Tools 
Soldering tools (through-hole), AVRISP 


Cost 
Approx. €15 


Since its introduction in 1986, the Inter- 
Integrated Circuit Sound (12S) bus has been 
the “de facto” standard for transmission of serial 
digital audio signals. During the development 
and test of our “Audio DAC for the Raspberry 
Pi" [1], we came up with the idea to design a 
dedicated circuit that generates an 12S signal 
to test the DAC without connecting the RPi as 
signal source. This circuit can of course also be 
used to test other audio DACs with 12S inputs, 
provided that they can handle the 192 kHz 
sampling frequency and 24- or 32-bit audio data. 


Design options 

To build an 12S test signal generator, one 
option would be to use a 24-bit ADC with 
12S outputs, with a signal (sine wave) genera- 
tor as input. But to check if the analog output 
signals of the DAC are indeed flawless, the 
sine wave in the 12S signal must be perfect 
to perform proper distortion measurements. 
The test signal should not be degraded by 
an inferior analog source or ADC in any way. 


As an alternative, a microcontroller can be 
used to generate the I2S signal, using a table 
with 32-bit samples that can be accurately 
calculated to ensure the quality of the audio 
data. This will generate a signal that is perfect 
for distortion measurements, in this case a 
1 kHz sine wave with 192 kHz sample rate. 

















11 SCLK 
12.288MHz 





















Figure 1: Schematic of the 12S signal generator. 


It would be obvious to use a microcontroller 
that supports 12S for this task, but why not 
use a very common microcontroller like the 
ATmega328P instead? The problem of course 
is that it doesn't support 12S. It was quite a 
challenge to build a digital sine wave genera- 
tor with 12S output using this microcontroller 
and some additional hardware, but this project 
shows that it can be done! The firmware of 
the ATmega is developed in BASCOM-AVR. 


Some extra hardware is needed 

The goal is to create an 12S signal with 32-bit 
data at a sample rate of 192 kHz, which is 
close to the maximum sample frequency of 
the PCM1794A used in our RPi audio DAC. 


IC4=74HC86 
IC5=74HC74 


192kHz 





74AC4040 


The serial clock (SCK or SCLK) must be 
12.288 MHz (2 channels * 192 kHz * 32 bit). 
Since the maximum clock frequency of the 
microcontroller is 20 MHz, the only way to 
output serial data (SD or SDATA) faster is 
to use an external parallel-in serial-out shift 
register and use the clock of the microcon- 
troller to clock the shift register. PBO must 
be configured as CLKO (Clock Out) when 
programming the fuses of the ATmega328. 
The complete schematics of the signal gener- 
ator can be seen in Figure 1. Apart from the 
shift register a ripple counter, a flipflop and 
some Exclusive-ORs are added to free the 
microcontroller from other (timing) tasks than 
just outputting the bytes of the samples. 


HCAMORESET — 


TAHCTASDATA_ 


HC165 QH bits 


HC165 CLOCK 
HC165 LOAD ~~ 


HC4040 CLOCK 





CLK=SCLK=12.288 MHz, fs = 192kH2 

2S: SDATA is clocked on the low to high transition of SCLK 
bit31=MSB 

bitO=LSB 


Figure 2: Timing diagram. 
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(CD 
COMPONENT LIST 


Resistors 
R1=2.2k 
R2=100Q 
R3=10k 
R4=150Q 


Capacitors 
C1,C2,C4 = 22 pF, COG/NPO, 
lead spacing 5 mm 
C3,C5,C6,C7,C8,C9 = 100 nF, X7R, 
lead spacing 5 mm 


Semiconductors 

LED1 = LED, green, 3 mm 

IC1 = ATmega328P-PU, 20 MHz, DIP28 
IC2 = 74HC165 

IC3 = 74AC4040 - do not use HC logic !!! 


eared 
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Figure 3: PCB layout. 


All other software tasks, like calculating the 
32-bit sine wave and creating the array of 
sample bytes, must be done before the main 
loop of the program starts. The 32-bit samples 
are divided into four bytes. This means the 
size of the array must be 4 * 192 = 368 bytes. 
Left and right channel use the same signal, so 
each group of four bytes per sample must be 
repeated. The number of lines this part of the 
main loop takes can be calculated: 


2 channels * 4 bytes * 192 samples * 4 lines 
- 3 = 6141 program lines 


After the last sample byte in the loop, the three 
NOPs are omitted as the restart of the loop 
takes three clock cycles, which explains the 
“-3" in this calculation. 


IC4 = 74HC86 
IC5 = 74HC74 


Other 

K1 = 2x3 pin header, vertical, pitch 2.54 mm 

K2 = 1x4 pin header, vertical, pitch 2.54 mm 

K3 = Terminal block 5.08 mm, 2-way, 630 V 

S1 = Rotary Coded Switch, hexadecimal, real 
code, THT (e.g. Nidec Copal Electronics 
SD-1010) 

S2 = Switch, tactile, 24 V, 50 mA, 6x6 mm 

X1 = Crystal 12.288 MHz, C-load 18 pF, 10 ppm, 
HC-49S 

PCB 200253-1 v11 
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The hardware, in more detail 

The timing diagram in Figure 2 can help to 
choose the external components. The 12S 
bus comprises three signals: the serial data 
(SDATA) is clocked on the rising (low-to-high) 
edge of the serial clock (SCLK) and the word 
select line (WS or LRCLK) indicates the audio 
channel (0 for left, 1 for right). Its frequency is 
equal to the sampling frequency of the digital 
audio signal (192 kHz) and can be derived 
from the serial clock. The serial data and word 
select line both must change on the falling 
(HIGH-to-LOW) edge of the serial clock. The 
HC-logic family is in principle fast enough to 
be used as external components, although 
propagation delay of the gates must be 
corrected at one point: 12 ns delay is almost 
15% of the microcontroller's clock period. 
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A 74AC4040 (IC3, 12-stage binary ripple 
counter) is used to properly align the 12S 
signals. This counter advances on the falling 
edge of the clock input. It also has a master 
reset (pin 11) that can be used to synchronize 
it with the microcontroller. The sixth flip-flop 
(pin 2) divides 12.288 MHz by 64 and outputs 
exactly 192 kHz, the frequency we need for 
the word select line. 


At the start of the program, the reset of the 
counter is activated (high). It is deactivated 
just before the start of the main loop (i.e., 
about a quarter of a second after power up, 
which is all the time it takes to create the 
array). This reset signal synchronizes the data 
at the output of the shift register and the word 
select line. First three samples with value 0 
and a few NOPs are used so the first byte is 
at the output of SDATA at the correct moment. 
There is a window of seven clock cycles for 
the first MS-byte to be clocked into the shift 
register. Each byte at port D is replaced by the 
next after eight clock cycles. In other words, 
the moment the first MS-byte at port D can 
change relative to the load pulse of the shift 
register may vary seven clock cycles (see 
timing diagram). The data at the output of 
port D changes a few nanoseconds after the 
rising edge of CLKO (PBO). 


An 8-bit parallel-in/serial-out shift regis- 
ter 74HC165 (IC2) is used for serial data. It 
has an active low parallel load (pin 1) and 
a clock (pin 2) with inhibit (pin 15, active 
low enable) which have the same function- 
ality (both internally connected to an OR 
gate). Depending on component place- 
ment swapping connections can simplify 
routing. Data is shifted on the rising edge of 
the clock. The serial input (pin 10) is not used 
and connected to ground. The load pulse (LD, 
active low) for the shift register is derived 
from counter output Q4 using Quad 2-Input 
Exclusive-OR 74HC86 (IC4). The signal to pin 
4 of IC4B is inverted and delayed by IC4A 
by its propagation delay and an extra delay 
of a few nanoseconds by R4/C4. Because 
of the Exclusive-OR function each change 
of Q4 gives a short active low pulse at the 
output of IC4B. The pulse is long enough to 
load the new data into the shift register but 
short enough to be inactive before the rising 
edge of the clock. To load the data from port 
D into the shift register at the correct moment 
the pulse must be active just after the rising 
edge of the clock (pin 1). This means the 
clock of the shift register must be inverted, 
which is done by IC4C. 





The most significant bit of the serial data of 
the 12S bus is located one clock period after 
the change of word select. An extra D-type 
flip-flop is needed. Selected is a 74HC74 (IC5), 
a dual D-type flip-flop with set and reset and 
positive edge-trigger. By doing so, the signal 
for SDATA is delayed. To compensate for this 
the inverted clock signal of IC4C is inverted 
again by IC4D to make the serial clock line 
up with the serial data. 


Adjusting the output level 

Instead of just producing a 1 kHz sine wave 
with a fixed level, four inputs of port C (with 
internal pull-ups) are connected to a hexadec- 
imal coded rotary switch (SD-1010) to adjust 
the output level. This feature can be used 
to check linearity of the DAC. A four-way 
DIP-switch could have been used instead 
but changing levels is easier with the rotary 
switch, much like an analog volume control. 


There are ‘real code’ and ‘complementary 
code’ type of rotary coded switches. The ‘real 
code’ version is used in this project, but other 
types can be used if the software is changed. 
In position ‘0’ all four switches are open. To 
change the output level for the digital audio 
signal, the microcontroller must be reset to 
recalculate all values in the sample array, hence 
the presence of button S2 that must be pressed 
to reset the microcontroller when the output 
level is changed. A Select-Case statement is 
used to set the scale factor U (type Double) to 
the correct value for each level-setting. 


The correct values for the scale factors for 
each output level are defined as constant 
values in the program not only to avoid extra 
calculations, but also because calculations 
using BASCOM's LOG function in the program 
are not accurate enough. 


Calculating the sine wave 

As mentioned earlier, the program calculates 
the sine wave sample table immediately after 
power up or reset, taking into account the 
level setting of rotary switch S1. The purpose 
of this project was not only to build “some” 
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12S signal generator, but also to make a 
perfect 1 kHz sine wave test signal with 32-bit 
accuracy. First the BASCOM-AVR instruc- 
tion for SIN(x) was used in the calculations, 
but that isn’t accurate enough, as following 
examples show: 


DIM Pi,A,X As Single 
Pi = 3.1415926535897932384626433 


X = Pi / 2 
A = SIN(X) 
Print "Sin(Pi/2) =" 5A 


This piece of code results in: 

Sin(Pi/2) = 0.99999332, whereas the result 
should be exactly 1. And for X = Pi/6 the 
result is 0.499993796, but should be exactly 
0.5. So, for calculating an extremely accurate 
sine wave, this is just not good enough. The 
only option is to calculate the sine wave using 
the Taylor polynomial for SIN(X) with suffi- 
cient terms: 


SIN(X) = X-(XA3)/3!4-(X45)/5!- 
(X^7)/7!+(X^9)/9!-(X^11)/1!+(X™3)/13! 
-(X^15)/15! 


In BASCOM-AVR calculations can only be 
performed on two operands; therefore, the 
polynomial is calculated in many lines of 
source code, as can be seen in the source 
code of this project. 


To speed things up, the factorial calculations 
are avoided and constants are used instead 
(F3 = 6 ... F15 = 1307674368000). All variables 
in the calculations are of type Double, signed 
64-bit binary numbers (8 bytes, 5 x 10^-324 
to 3.4 x 10^308). With the Taylor polynomial 
we get the following, more accurate results: 


Sin(Pi/6) = 500E-3 
Sin(Pi/2) = 999.999999993977E-3 


To split up the result of the calculation 
of SIN(X) into four bytes it must first be 
converted to a variable of type Long, signed 
32-bit binary numbers (-2147483648 to 
2147483647). The result of the calculation of 


SIN(X) is in the range of -1 to 1, if we want the 
32-bit data to have a full-scale level the value 
of SIN(X) must multiplied by (2^32)/2 - 1: 


SINX = SINX * U 
Where U = 2147483647 


The conversion to Long can be done in just 
one statement, a Long variable gets the value 
of a Double variable. Now, the result of the 
calculation is available as a signed 32-bit 
value: 


SINXIong = SINX 


Splitting up this value into four bytes is just 
a matter of shifting the bits of SINXlong and 
store them in four variables of type Byte. A 
subroutine called SampleX does all these 
calculations for any value of X. But the calcula- 
tion is only really accurate for X = -11/2 through 
+m1/2. So, first the sine wave is calculated from 
-t1/2 through +1/2, taking 97 samples (four 
bytes per sample). The rest of the array is 
completed by mirroring the elements of the 
first array per group of four bytes, taking 95 
samples. Sample 193 is the same as the first 
of the array (four bytes). The Do-Loop restarts 
there. 


It would have been possible to create an array 
with only samples of the sine wave from -11/2 
through +m/2 and select the correct array 
elements in the main loop to complete the 
data for a full sine wave period at port D. But 
instead of a sine wave a more complex signal 
that is not symmetrical can be interesting for 
other purposes. And if a complete array is 
used, the main loop is easier to read. 


With the aid of the shift register, the micro- 
controller has eight clock cycles to process 
each byte. 


In BASCOM-AVR the instruction PORTD = 
A(n), where A(n) is an element of a byte 
array, only takes five clock cycles when used 
in Do-Loop, surprisingly fast. To make each 
byte take eight clock cycles three NOPs must 





[1] Audio DAC for Raspberry Pi: www.elektormagazine.com/labs/audio-dac-for-rpi-networked-audio-player-using-volumio 


[2] Downloads gerber files and software: www.elektormagazine.com/200253-01 


[3] This project's Elektor Labs page: www.elektormagazine.com/labs/32-bit-i2s-sine-wave-generator-200253 
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Figure 4: The prototype of the generator on Veroboard. 


be added after every byte. It takes three clock 
cycles for the Do-Loop to restart, which is 
perfect to produce one full period of 192 
samples of a 1 kHz sine wave. So the only 
thing the main loop of the program has to do 
is to output the bytes of the array to port D. 


Building the hardware 

We have designed the PCB shown in Figure 3 
for this project, the layout and the Gerber 
files are available for download. Alternatively, 
you can use a piece of Veroboard, as our 
designer did in the first prototyping phase 
(see Figure 4). 

If you are unable to find a supplier for the 
74AC404Q, it is possible to cut the connection 
between pin 13 and 14 of IC4. By connect- 
ing pin13 to ground with a jumper wire a 
74HC4040 can be used, but timing is far from 
optimal and could pose a problem with the 
DAC being tested. This correction works with 
our RPi DAC though. The wires from K2 of 
the generator to the DAC should be kept as 
short as possible. 


The supply voltage of this circuit must 
match the voltage of the DAC under test. At 
VCC = 3.3 V, the current consumption is just 
over 20 mA. 


Changing software... 
The program uses 77% of flash memory 
space. Just calculating the sine wave as 


described earlier in this article needs about 
10%. So there is some space left in program 
memory to extend the code and add extra 
features. Note that the free demo version of 
BASCOM-AVR can not be used to compile the 
software due to its program memory limita- 
tions, you'll need to buy a registered version 
if you want to change the program. 


The software download for this project [2] 
contains the HEX-file for the original firmware, 
so this project can be built without a licensed 
BASCOM-AVR version, just an AVR-ISP 
programming interface and programming 
software like Atmel AVR Studio or AVRDUDE 
will get your ATmega128 up and running. 


„Or hardware 

There are still some I/O pins of the micro- 
controller unused that can be implemented 
to control additional features, like changing 
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Questions or Comments? 

Do you have questions or comments 
about his article? Email the author at 
T.Giesberts@elektor.com. 


the waveform or frequency. Of course, you'll 
need to change the software to support such 
functions. Microcontroller pins PB2, PCO 
and PC1 can be used without any problem, 
whereas PB4 and PB5 are dedicated pins for 
In System Programming (ISP) and care must 
be taken that additional connected compo- 
nents don't interfere with this programming 
interface. 


LED1 was added to indicate that the proces- 
sor is busy calculating the audio sample data, 
but since this is finished in only a quarter of a 
second PB3 can also be used for additional 
features. In that case, R1 can be connected 
to the power supply as power-on indicator. 


If and when you add functionality to this 12S 
signal generator, if you have any other remarks 
or suggestions regarding this project, don't 
forget to share it with us and other readers 
on the Elektor Labs page [3]! I 
200253-01 
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Idea, Design, Text: Ton Giesberts 
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> RPi High End Audio DAC - Bare PCB (160198-1) 
www.elektor.com/rpi-high-end-audio-dac-pcb-160198 


> Raspberry Pi High End Audio DAC - Module (160198-91) 
www.elektor.com/raspberry-pi-high-end-audio-dac-module-160198-91 
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Control Your Home 
with Raspberry PI 


RP! snoops on 433.92 MHz 


By Koen Vervloesem (Belgium) 


This installment of Elektor Books 

presents a chapter excerpted from Koen 
Vervloesem’'s book Control Your Home 

with Raspberry Pi, which was recently 
published by Elektor. Koen explains how 
to turn your RPi into a powerful receiver 
and decoder for most, if not all, remote 
control and sensor signals you can pick up 
at 433.92 MHz, one of the best-known and 
widest-used ISM frequencies. 


In the DIY community (at least in Europe where I'm living), 
433.92 MHz will ring a bell. Many cheap wireless devices such as 
garage door openers, weather sensors, and doorbells are using this 
frequency. Moreover, the hardware to communicate with these 
devices is equally cheap. 


The disadvantage is that most of these devices use plain 
unencrypted radio communication, and if they do use some sort 
of security, it’s quite weak and/or some proprietary algorithm that 
doesn't inspire much confidence. But there are so many available 
devices and they are so cheap, that you can't ignore them. For 
security reasons, I only use 433.92 MHz temperature sensors: I 
have one of them in almost every room of my house, and outside 
too. I wouldn't trust 433.92 MHz devices for critical tasks. 





In this chapter, I show you how you read measurements of these 
wireless temperature sensors and how to relay them to your MQTT 
broker for further integration in your home automation system. 


Note: in this book, I'm talking about 433.92 MHz, but depending 
on where you live you have to substitute this by another frequency. 
For instance, in the Americas, the corresponding frequency is 
915 MHz. Just make sure that you buy the correct devices for 
your country. 


@ilektórbook 


Control Your Home 
with Raspberry Pi 


Koen Vervloesem 





433.92 MHz protocols 

Devices that are using the 433.92 MHz frequency operate in the 
unlicensed industrial, scientific, and medical (ISM) frequency 
band. But the frequency is one thing, the protocol they’re using 
is another one. There's no standard protocol for this frequency. 
This is no Z-Wave or Zigbee. However, many protocols of these 
devices have been reverse engineered, and you can talk to them 
as long as you have a transceiver for the frequency band around 
433.92 MHz and the right software to decode and/or encode 
the protocol. 


Some interesting devices are: 

> temperature, humidity and weather sensors by Alecto, Cresta, 
La Crosse, and Oregon Scientific; 

> door/window sensors with Hall sensor; 

> switches and dimmers by Energenie, KlikAanKlikUit and 

LightwaveRF; 

> doorbell chimes by Byron and Chacon. 


You can also find many even cheaper devices on AliExpress and 
Banggood that support the same protocols. And there are even 
small PCBs such as the STX882 transmitter that you can connect to 
a microcontroller or an Arduino board to create your own wireless 
sensor boards. 
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Figure 1: For around €5 you 
can find a temperature 

and humidity sensor from 
DANIU that transmits its 
values over 433.92 MHz and 
shows it on a clear display. 


RIL-SDR 


QUICKSTART SETUP SUIDE: RTL-SOR.CON/SS 
DVB-T+DAB+FM+SDR 







Figure 2: The RTL-SDR decodes a lot of wireless signals, including weather 
sensors transmitting on 433.92 MHz. 
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Figure 3: With the tripod mount, dipole base and telescopic antennas from 
the RTL-SDR kit, you have all you need to receive measurements from all 
your 433.92 MHz sensors. 


In this chapter, I’m focusing on the first types of devices: tempera- 
ture and humidity sensors. You can find these for less than 10 euros 
(Figure 1), even for a few euros on AliExpress or Banggood. Their 
range is quite good: I can read sensors in my whole house, including 
in my fridge and freezer, and even on my terrace outside. 


28 January & February 2021 www.elektormagazine.com 








Hardware requirements 
For your Raspberry Pi to be able to receive 433.92 MHz sensor 
measurements, you need a receiver and an antenna. 


Receiver 

A popular type of receiver for 433.92 MHz projects is a Realtek 
RTL2832 based DVB dongle. Yes, you read that right, DVB as in 
Digital Video Broadcasting. As it turns out, the RTL2832 chip in 
many of these dongles can do quite more than decoding digital 
video signals: with the right software, you can create a true 
software-defined radio (SDR) with it. 


So if you have an old DVB dongle lying in your closet, chances are 
that you can use it to receive signals from your weather sensors. 
Otherwise, the RTL-SDR (https:/Avww.rtl-sdr.com) is a good choice 
(Figure 2). You can find variations of this stick for €25 andin a kit 
with an antenna and other accessories for €40 to €45 [1]. You can 
find something useful even cheaper: I have read about €7 DVB 
dongles on AliExpress that are working perfectly for this purpose, 
but I haven't had any experience with them. 











Antenna 

The next item you need is a good antenna. There are whole books 
written about antenna theory, and I’m not going to delve into this 
vast topic because I’m no antenna specialist. 


One thing you should know for the choice of your antenna is 
its length. This depends on the wavelength of the signal. The 
wavelength equals the speed (in m/s) divided by the frequency 
(in Hz), and is measured in metres (m). Let’s do the maths for 
433.92 MHz communication. In air, the speed of the wave is virtu- 
ally the speed of light. So the wavelength becomes: 





299,792,458 m/s / 433,920,000 Hz = 0.69 m. 


So the full wavelength is 69 cm, the half-wavelength is 34.5 cm, 
and the quarter-wavelength is 17.25 cm. These are the theoretical 
optimal lengths for an antenna to receive 433.92 MHz transmis- 
sions. In practice, various factors are influencing the antenna’s 
characteristics, including positioning, and there’s a rule of thumb 
to subtract 5% from this theoretical length. 


Again, this is not an antenna theory book, so I'm not going to talk 
about the different types of antennas. Moreover, for reading sensor 
values in your house it doesn’t even matter that much what the 
quality of your antenna is. You could try experimenting with it, but 
chances are that it just works if you buy a ‘433 MHz antenna’ fora 
few euros on AliExpress or Banggood. If you don't want to take any 
chances, use an antenna included ina kit with the RTL-SDR. The 
official antenna kit (Figure 3) has telescopic dipole antennas you 
can extend from 5 cm to 1 m, which covers the optimal wavelengths 
for the 433.92 MHz frequency [2]. 














Receiving sensor values with rtl_433 

On the software side, a popular choice to read 433.92 MHz signals 
is ‘rtl_433' (https://github.com/merbanan/rtl_433), which despite its 
name is a generic data receiver, mainly for the 433.92 MHz, 868 MHz 
(SRD), 315 MHz, 345 MHz, and 915 MHz ISM bands. 











Any Realtek RTL2832 based DVB dongle should work with rtl_433, 
including the official RTL-SDR dongle. I’m using the RTL-SDR 
dongle with a dipole antenna from the RTL-SDR antenna kit. Just 
connect the antenna to the RTL-SDR and put the RTL-SDR in a USB 
port of your Raspberry Pi. 


Warning: The RTL-SDR produces quite a lot heat while it’s running. 
Take care of where you position it. 


Installing rtl_433toMQTT 

The rtl_433 program is actively developed and maintained and has 
more than 150 protocol decoders for various devices that trans- 
mit on 433.92 MHz. Moreover, it can send the received values to 
an MQTT broker. Luckily, someone created a Docker container 
with rtl_433 for this exact purpose (https://github.com/bademux/ 
rtl_433toMQTT) [3]. 


First, create a directory for the container: 


mkdir -p /home/pi/containers/rtl433tomqtt 


Then add the container definition to your docker-compose.yml file: 


version: ‘3.7’ 
services: 
mosquitto: 
# mosquitto config 
rtl433tomqtt: 
image: bademux/rtl_433tomqtt: Latest 
container_name: rtl433tomqtt 
restart: always 
volumes: 
- ./containers/rtl433tomqtt: /home/user/.config/ 
rtl_433:ro 
- f/etc/localtime:/etc/localtime:ro 
devices: 
- /dev/bus/usb:/dev/bus/usb 


tri 


nter the configuration of the Docker container for Mosquitto 
instead of ‘#mosquitto config’. The container needs access to 
the USB bus to read from the RTL-SDR device. Note also that the 
directory you created is mounted as a volume. You don't have to 
create a configuration file yet. 





First create a udev rule to give the right permissions to the USB 
device: 


sudo nano /etc/udev/rules.d/20.rtl-sdr.rules 
Enter the following line: 


SUBSYSTEM=="usb", ATTRS{idVendor}=="Obda", ATTRS{idPr 
oduct}=="2838",OWNER="pi", MODE="0660" 


Save the file with Ctrl+o and exit nano with Ctrl+x. Then unplug 
the RTL-SDR and reattach it. Now look at the list of attached USB 
devices: 


lsusb 





Figure 4: The rtl_433 command automatically finds the RTL-SDR receiver 
and starts showing received sensor readings. 


Search in this list for a line like this: 


Bus 001 Device 008: ID Obda:2838 Realtek 
Semiconductor Corp. RTL2838 DVB-T 


Note the bus and device number: 001 and 008. Now look at the 
device files for the bus 001: 


ls -l /dev/bus/usb/001 
You should see a line like this: 
crw-rw---- 1 pi root 189, 10 May 7 20:22 008 


This shows that the device is owned by the user pi, which has read 
and write permissions. 


After this, create the container with: 


docker-compose up -d 


After the container has been created, look at its logs: 


docker logs -f rtl433tomqtt 


As shown in Figure 4, you should see some messages that the 
rtl_433 program is trying to find a configuration file in a few places, 
that is has registered more than 120 decoding protocols, and that 
is has found a receiver device. Then you should see a message 
‘Tuned to 433.920MHz’ and if all goes well you should now see 
sensor values coming in. Have some patience, because many of 
these sensors only transmit once a minute. 


Configuring rtl_433 
n the beginning ofthe logs, you saw that rtl_433 tried to find some 
configuration files. It didn't find one, so it just used a default configu- 
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Figure 5: The rtl_433 command can show the sensor values in many 
formats, including JSON. 





Figure 6: The rtl_433 command can send the received sensor values to your 
MQTT broker. 


ration, which was fine for testing but didn’t use MOTT. Now let's copy 
an example configuration file to a path where rtl_433 is searching: 


docker cp rtl433tomqtt: /usr/local/etc/rtl_433/ 
rtl_433.example.conf /home/pi/containers/ 
rtl433tomqtt/rtl_433.conf 


Because I have mapped the directory containers/rtl433tomatt in 
your pi user's home directory to /home/user/config/rtl_433 in the 
container, you can now edit this configuration file and restart the 
container to use this configuration. For instance, you can disable 
protocols you don't need, or enable protocols that are disabled 
by default. 


The configuration file is heavily commented, which should help 
you figure out what to change. Moreover, you can find a lot of 
information in rtl_433's online documentation (https://triq.org/ 
rtl_433/), including steps to add support for a sensor that is not 
(yet) supported. 


After the changes to your configuration file, restart the container: 


docker restart rtl433tomqtt 


If all goes well, the logs should show that rtl_433 stops searching 
for a configuration file after the second file and finds it: 


Reading conf from "/home/user/.config/rtl_433/ 
rtl433.conf". 
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With the example configuration file, rtl_433 now shows the output 
of each sensor as aJSON dictionary (Figure 5). This is already a big 
step forward to integrate your 433.92 MHz sensors into your home 
automation setup, but the final step is to publish these values to 
your MQTT broker. 


Publishing 433.92 MHz sensor values to MQTT 
The rtl_433 program has already support for sending the sensor 
values it receives to an MQTT broker. Open the configuration file 
(/home/pi/containers/rtl433tomatt/rtl_433.conf) and find the line 
that says: 


output json 


You can keep this line here because you can specify multiple 
outputs, or change it to output kv if you prefer the default more 
human-friendly output. Add the following line to define an MQTT 
output: 


output mqtt://mosquitto:1883,user=home, pass=PASSWORD 


Make sure to enter the correct username and password for your 
MQTT broker. 


Warning: The rtl_433 program doesn’t support MQTT over TLS. If 
you're running the rtl_433toMQTT container on the same Raspberry 
Pi as your mosquitto container, it's no problem that they communi- 
cate unencrypted: they're on the same machine anyway. If you have 
your RTL-SDR receiver on another machine than your MQTT broker 
(for instance because you have better coverage there), I recom- 
mend you runa mosquitto container aside from the rtl_433toMQTT 
container and configure it as a bridge to your main MQTT broker 
over an encrypted connection. See the appendix at the end of this 
book for the details. 














After a restart of your container, you should see an MQTT message 
published under the rtl_433 main topic for each sensor value. You 
can view this with: 





mosquitto_sub -t ’rtl_433/#’ =y 


For instance, every time the temperature and humidity sensor in 
my freezer transmits a message, I see data like in Figure 6. 


Now, you can still tweak a couple of things from the MQTT config- 
uration. Consult the comments in the example configuration file 
for the details. For instance, this configuration changes the MQTT 
topics to something shorter: 


output 
mqtt://mosquitto:1883,user=home , pass=PASSWORD, device 
s=rtl433/[model]/ [channel]/[id] 


And if you're not interested in the low-level metadata about the 
radio connection, such as modulation, frequency, RSSI (received 
signal strength indicator), SNR (signal-to-noise ratio) and noise, 
just remove or comment out the report_meta level line in the 
configuration file. 





Questions or Comments? 
If you have any questions regarding this article, feel free to 
contact the author by email at koen@vervioesem.eu. 


So there you have it: all the measurements of your 433.92 MHz 
sensors are sent to your MQTT broker, and you can subscribe to 
their topics in your Python scripts or your other home automa- 
tion software. 


Summary and further exploration 

Wireless devices in the 433.92 MHz frequency band are very popular 
in the DIY community and they are cheap and easy to find in a lot of 
places. Especially interesting are temperature and humidity sensors 
that you can use to monitor your fridge, freezer, or greenhouse. 





All you need to read these sensors is a cheap DVB dongle and an 
antenna. The rtl_433 program supports more than 150 protocols 
of 433.92 MHz devices and lets you relay the received signals as 
messages to your MQTT broker, so your other home automation 
software can act upon them. 


There are still a lot of interesting topics I barely touched, such as 
the optimal antenna choice and placement for better coverage. It's 
also an exciting exercise to try to add support for an unsupported 
device to rtl_433. The project has detailed documentation about 
how you capture the raw signals and how you should try to reverse 
engineer the protocol. 





You can also try other receivers, for instance, the RFXtrx family of 
devices, which even includes a transceiver that lets you control 
Somfy RTS roller shutters. There’s even a Python library, pyRFX- 
trx (https:/github.com/Danielhiversen/pyRFXtrx), to communicate 
with your 433.92 MHz devices using a RFXtrx transceiver. Home 
Assistant (see Chapter 10) is using this library for its support of 
433.92 MHz devices. However, the RFXtrx transceiver costs a lot 
more than a RTL-SDR. 


At the other end of the price spectrum, if you want to try what you 

can do with the cheapest possible equipment, the STX882 trans- 

mitter and SRX887 receiver are good places to start. M 
200534-01 


= LINKS & LITERATURE 


[1] Elektor RTL-SDR kit with antennas, mounts and extension cable: 


CONTROL YOUR HOME 
WITH RASPBERRY PI 


This book shows you how you 

can automate your home with a 
Raspberry Pi. You'll learn how to 

use various wireless protocols for 
home automation, such as Bluetooth, 
433.92 MHz radio waves, Z-Wave, 
and Zigbee. Soon you'll automate 
your home with Python, Node-RED, and Home Assistant, and 
you'll even be able to speak to your home automation system. 
All this is done securely, with a modular system, completely 
open-source, without relying on third-party services. You're in 
control of your home, and no one else. 


Control Your Home 
with Raspberry Pi 





At the end of the book, you can install and configure your 
Raspberry Pi as a highly flexible home automation gateway for 
protocols of your choice, and link various services with MQTT 
to make it your own system. 


> Turn your Raspberry Pi into a reliable gateway for various 
home automation protocols. 

> Make your home automation setup reproducible with Docker 
Compose. 

> Secure all your network communication with TLS. 

> Create a video surveillance system for your home. 

> Automate your home with Python, Node-RED, 
Home Assistant and AppDaemon. 

> Securely access your home automation dashboard from 
remote locations. 

> Use fully offline voice commands in your own language. 


The software and errata for the book are available on on GitHub. 
https://github.com/koenverviloesem/ 
raspberry-pi-home-automation 


> Hard copy: 
www.elektor.com/control-your-home-with-raspberry-pi 


> e-Book: 
www.elektor.com/control-your-home-with-raspberry-pi-e-book 


Contributors 
Author: Koen Vervloesem 
Illustrations: Koen Vervloesem 


Editor: Jan Buiting 
Layout: Giel Dols 





www.elektor.com/rtl-sdr-software-defined-radio-with-dipole-antenna-kit 


[2] Using a dipole antenna kit on the RTL-SDR: www.rtl-sdr.com/using-our-new-dipole-antenna-kit/ 


[3] Right before this book was finished, the developer announced that he wouldn't actively develop this Docker image (which has more 
than 100,000 pulls) anymore, so there will be no new features. It remains to be seen if another image becomes popular. 
But even if you need to find another one, you should only need some minor changes to use it: the main configuration file of rtl_433 


stays the same. 
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Sevial Monitoy 


Simulate 
Circuits Online 


It is often the case that you don’t have all the 
components required to build a circuit that is 
developing in your mind. Or, perhaps the circuit 

you wish to develop uses dangerously high voltages 
and currents. In such cases, it makes sense to use 

a simulator to test the idea in safety. Simulators 

are now commonly available, with the Tinkercad 
Circuits platform covered here accessible in your web 
browser. As well as simulating circuits, it can also 
execute Arduino code, as we show here. 


By Florian Schaffer (Germany) 
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SPICE (Simulation Program with Integrated Circuit Emphasis) is the 
best-known software for simulating analogue and digital electrical 
circuits. Unfortunately, it is not that user-friendly and it requires the 
circuit diagram to be expressed in its own special format. So it is good 
news that a graphical interface, Tinkercad Circuits, has been developed 
that allows you to use it online. There is no need to install any software 
and you can build your circuit exactly as if it were on a breadboard. 
It also also offers integration of ATmega (as used in the Arduino Uno) 
and ATtiny microcontrollers. You can write and execute your programs 
in C or C++, or simply use the Scratch visual programming language. 
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Switch to the Circuits section of the Dashboard. At the bottom edge, 
you can change the language if necessary. 


Start by logging in to the website https://www.tinkercad.com. You 
can either create a new account or use a third party account such 
as Google. From the dashboard, go to the area called Circuits. At the 
bottom of the screen you can change the user interface language if 
you wish. As a new user you will not have any designs visible. 

The project created for this article can be found at 
https://www.tinkercad.com/things/azigBrXUclZ. 





1. | Click on ‘New circuit: The breadboard view is similar in many 
ways to that offered by Fritzing. Therefore, it is a good idea to get to 
know Fritzing and read our article about that tool it in the previous 
issue. 


EA Your design will be permanently stored in the cloud. At the top 
of the screen next to the Tinkercad logo you will find that a made-up 
name has already been assigned to your project. You can click on the 
text there and change it to something more appropriate. 
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EJ On the right-hand side you will see a selection of example 
projects and components. Under Basic in the selection list you 
can find a number of examples that you can try out. Since we 
are creating a new project from the beginning choose All under 
Components. 


O- s 


Code P Start Simulation Export Share 


Components 


Basic 





Starters 
Basic 
Arduino 
Circuit Assemblies 


All 





CA From the component selection list choose a power source 
(bench supply), the Arduino Uno R3 and the small breadboard. 
Click on each symbol in turn and place them in the working area. 


©@lektor January & February 2021 33 




















5. In many cases it is possible to adjust the parameters of a 
component such as colour, type or dimensions by clicking on it 
in the working area. This opens a small dialogue box showing the 
settings that can be changed. Click on the power supply and set 
the Voltage to '5: You can also use a decimal point for this value if 
required. 


Power Supply 


Ea 
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Current i 








6. Place the components and the wiring on the breadboard. 
In the diagram you will see which values can be changed for each 
component. 






Potentiometer 
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EA A common connection to the GND pin on the Arduino is also 
required (black line running off to the right) as well as the (blue) 
connection to pin A2.. 


EJ When you have finished building the circuit you can test its 
electrical functions and simulate it. Just click on Start Simulation at 
the top of the screen. A brief animation will show the USB plug be- 
ing plugged into the Arduino to show that it is now being provided 
with power, and the ‘ON’ LED will light. At the moment, however, 
there is no program for the Arduino to execute. The power supply 
will also show its output voltage and the instantaneous current be- 
ing drawn. 


9. You can click with the mouse on the controls of the pow- 
er supply and drag them around. The main part of the circuit will 
withstand up to around 18 V, but not the Arduino connected over 
the blue wire. In real life you would destroy the microcontroller like 
this, but in this simulation you cannot do any damage. The piezo 
sounder will emit a spluttering sound if you have a loudspeaker 
connected to your PC. You can use the mouse to adjust the blue 
potentiometer at the top left of the breadboard: as you turn it, the 
sound will change. 











mo 
-9 








10. | Click on Stop Simulation and then on Code (next to it on the 
left) to open a window that will allow you to enter source code. The 
‘code view’ will slide in from the right-hand side and, initially, you 
will be presented with the Scratch editor. At the top you can change 
to Text (note: a warning will pop up, which you can dismiss). 
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void setup( 
f 
i 


pinMode (13, OUTPUT); 


void loop() 


r 
i 


digitalWrite (13, HIGH); 


delay(1000); // Wait for 1000 millisecond(s) 
digitalWrite (13, LOW); 
delay(1000); // Wait for 1000 millisecond(s) 





11. | A small amount of ready-made code will appear in the win- 
dow. Delete all of this and replace it with the following commands. 


const uint8_t iopin = A2; 


void setup() 

{ 
pinMode(iopin, INPUT); 
Serial.begin(9600) ; 


void loop() 

{ 
Serial.println(digitalRead(iopin) ); 
delay(10) ; 


12. | When you next click on Start Simulation the program code 
will also be executed. If there are any syntax errors in your program 
they will be highlighted in the same way as in the Arduino IDE and 
must, of course, be fixed before continuing. 
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const uint8_t iopin = A2; 


1 (Arduino Uno R3) >~ 


void setup() 

p 

i 
pinMode (iopin, INPUT); 
Serial.begin (9600); 


void loop() 
t 


)); 








Sorry, it seems like your code has some errors. 





13. | In this example the Arduino will behave as a simple oscil- 
loscope, printing out the signal it sees on its input pin. This corre- 
sponds to the signal that is driving the piezo sounder. Click on the 
bottom of the code view window on Serial Monitor and you will be 
able to see the sequence of ones and zeros. In the far bottom right 
is a waveform icon. Click here to see a graphical representation of 
the signal. 


i 
Serial.println(digitalRead (iopin) ); 


aL [| Serial Monitor X 





PRRPEP OO: 








| | Send Clear Wiara 


14. Turn the potentiometer and, as the sound changes, you will 
also see the displayed waveform change. 


This article originally appeared in German in a special edition of 
Elektor offering an introduction to electronics based upon the Arduino 
platform. The English edition is now available: https://www.elektor. 
com/elektor-special-introduction-to-electronics-with-arduino. I4 
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From Life's Experience 


The fine line between order and chaos 


By Ilse Joostens (Belgium) 


Every now and then I go somewhere and 

it occurs to me that the desk of the typical 
electronics engineer stands in sharp contrast 
to that of the typical ‘bean counter’. The 
latter probably reflects an almost unhealthy, 
nearly sadistic desire to organise the world. 
Conversely, for the electronics engineers, 
chaos is trump and their workstation often 
looks like it is awaiting the arrival of a 
HAZMAT team. 


The work bench of the late Bob Pease, inventor of the in-beard 
breadboard, is an infamous example of a messy workspace [1]. We 
know better of course but an unsuspecting layman will have trouble 
spotting the difference between our bench and a photo of a disaster 
area after a tropical cyclone has passed through. Although often 
incorrectly attributed to Albert Einstein, we can still take solace 
in the quote: “If a cluttered desk is a sign of a cluttered mind, of 
what, then, is an empty desk a sign?” 


Chaos is not only a theory 

Although I have much to learn from Bob Pease, I have to admit with 
blushing cheeks that Iam an incorrigible slob. With my unstoppa- 
ble tendency for ‘heap forming’ I have driven my parents, manya 
former employer and even my partner to desperation. 


Years ago I was particularly busy with SMD components and we 
all know that it is better to leave them in their little bags, unless 
you want them to get lost or all mixed up. From this good habit 
the little bags with components piled up and, after a while, I had 
multiple stacks of storage boxes filled with various components. 





The consequences are predictable: every time I wanted to build 
a small series of circuit boards I spent more time looking for all 
the parts than the time it took to populate and reflow the boards 
themselves. How often have I ordered parts again that I still had 
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The classic bean counter, also known as an accountant. 


but could not find quickly enough or — even worse — deliberately 
not ordered components that were desperately required because I 
incorrectly thought still had plenty of them. There was, therefore, 
plenty of scope for improvement... 


Many ofus have a tendency to sort their components nicely by type 
and by value in storage containers or cabinets with drawers, with 
the surreptitious ulterior motive of collecting as complete a series 
of values as possible, such as the entire E24-series of resistors. This 
is a relatively good system for hobbyists, electronics designers and 
repairers but, when you are involved with manufacturing, this is 
far from flexible. 





buy the basic components and their through-hole equivalents in 
large quantities, depending on what I need for my products. As such 
it is not so wise to have thousands of every value of resistor in the 
E24-series in stock (as an example) when more than three-quar- 
ters of those values are practically never used. And that doesn't 
even take into consideration sorting them all nicely into drawers. 





Thanks to a little industrial espionage during an open-day at one 
of our suppliers I have come up with a better system. I now use 
racks and boxes where every box has its own code that indicates its 
location, such as “A5Ko”. This means rack “A”, shelf “5”, position “K” 
and then the first box from front to back. To know where a compo- 

















This system works quite well in practice. 


nent is I use a spreadsheet. The advantage of 
this system is that components do not need to 
be sorted. The box with microcontrollers can be 
located next to a box with screws. You can also 
easily move components around and empty 
locations can be reused for something else. 


The spreadsheet is not really the optimal 
approach but, unfortunately, I have not 
yet found an affordable and more suitable 
software solution. Additionally, there is 
always something that is not quite right. Now 
Tactually spend more time on the booking-in 
and booking-out of components and retriev- 
ing them from these boxes than populating 
and reflowing my circuit boards. Naturally I sometimes forget to 
book something in or out with the result that some orders still go 
wrong. Perhaps the chaos was not so bad after all. However, it is 
now much quicker to pass on the stock levels at the end of the year 
to our ‘bean counter’ — at least that isan improvement. 








Part ordering for dummies 

For improved ‘heap forming’ you obviously require components 
and then preferably different ones in large quantities. To be honest, 
Thaven't been to a classic electronics shop in years and these days I 
order everything online from the well-known wholesalers. Price is 
obviously important. However, I nevertheless recommend that, for 
critical components and semiconductors, you refrain from using 
suppliers in the Far East. Also, for reasons unknown to me, the 


Contributors 
Text and photos: Ilse Joostens 


== WEB LINK 


Translation: Arthur de Beun 
Editing: Stuart Cording 


selection of bright LEDs at the well-known wholesalers is rather 
poor and that is why I occasionally place an order via eBay. 


Normally I keep the websites of four or so suppliers open in different 
tabs in my browser. Whoever offers a component in the quantity 
I desire, at the best price, has my business. Because it is not likely 
that one supplier has everything in stock that I need, I usually end 
up with orders from at least three different suppliers. Consequently 
a parade of delivery vans turns up a few days later at my door. And 
then you get the jealous looks from the neighbour across the road 
who thinks that nearly every day is Christmas over here. Quite 
what he would do with a few thousand MOSFETs is anyone's guess. 





It also worthwhile to take a good look at the price break for bulk 
purchases. These normally encourage you to buy much more than 
you were intending. This has resulted in some strange pricing 
outcomes on more than one occasion. I have encountered that 
one hundred pieces of an IC came to the exact same price as 50 
pieces. I've come to the conclusion that free components really 
do exist! M 

200556-04 


Questions or Comments? 
Do you have questions or comments regarding this article? 
Then email Elektor at editor@elektor.com. 


Layout: Giel Dols 





[1] Bob Pease, ‘Whats All This Messy Office Stuff Anyhow?’: https://bit.ly/39AxMHx 
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BASIC COURSE 








By Eric Bogers (Elektor Netherlands) 


As promised in the previous 
episode of this series, we 
will now occupy ourselves 
with ‘tangible’ components 
—with resistors, to be more 
specific. A great deal more 
can be said about them 
than that which you may 
initially appreciate: there 
are resistors, resistors, and 
resistors... 


Resistors 

Resistors are classified as passive compo- 
nents because (in contrast to active compo- 
nents) they cannot amplify signals. Passive 
components include resistors, capacitors 
and inductors; active components include 
transistors, triacs and, yes, diodes are also 
considered to be active components. This isn't 
correct, strictly speaking (a diode, after all, 
does not amplify), but because we tradition- 
ally pile all the semiconductors into one great 
heap, diodes are also called ‘active’ 





Figure 1. A few resistors. 
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Putting this aside, let's first take a good look at 
what resistors actually look like. In Figure 1 we 
have portrayed the most common examples. 
At the bottom you will see a metal-film resistor 
and a carbon-film resistor above that, both 
with a power rating of 0.25 W. The power 
rating indicates the maximum power that 
a resistor can convert into heat without the 
resistor failing. This is something to keep an 
eye on! 


In addition to the maximum power rating we 
also need to consider maximum voltage rating. 
If this is exceeded, the resistor can break-over 
and it will likely fail. With the common-or-gar- 
den resistors that are typically used in hobby 
projects, the maximum voltage is generally 
rated at 250 V, so we don't have to worry too 
much about this in practice. 


Back to Figure 1: in the middle on the left 
are two resistors with a higher power rating 
(0.5 W and 1 W) and, right at the top, a cement 
version with a resistance of 39 Q that can 
handle 11 W. The power resistor in the middle 
on the right is a type that can be bolted to a 
heatsink that can handle up to 25 W. 


Normal resistors for regular use are small (the 
bottom two in Figure 1) — so small in fact that 
it is impossible to print their resistance value 
on them in a legible form. This is why the value 
is indicated with coloured bands. These days 
there are much smaller components available, 
known as SMDs or Surface Mount Devices 
but, because this series of articles is aimed 
at the electronics beginner and SMDs are 
not really suitable for an initial introduction, 
we will not go into these. We will stick with 
trusty ‘leaded; easily-handled components. 


The colour code 
There are resistors with both four and five 
coloured bands. The first two or three bands 
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indicate the value of the resistor. This has to 
be multiplied by a (power of 10) factor that 
is indicated by the penultimate band. The 
last band indicates the tolerance. Tolerance 
— what's that? When we take a batch of 
1000 Q resistors and measure them with a 
very accurate ohmmeter, we will find that no 
two resistors have the exact same value. For 
example, one will be 1001.3 Q, and another 
998.6 QO, an so on. This is because of unavoid- 
able small variations during manufacturing. 
The tolerance indicates the limits of the range 
of values that the resistor can have, with the 
actual value lying somewhere in between. 
For a 1000-Q resistor with a tolerance of 5% 
(this is a ‘normal’ carbon-film resistor) the 
actual value is somewhere between 950 Q 
and 1050 Q; with a 1% version (a metal-film 
resistor) the actual value is between 990 Q 
and 1010 Q. There is also a chance that outliers 
exist with values outside the tolerance range, 
but this does not happen very often. 


By the way, for most applications the 5% 
carbon-film resistors are good enough. Only 
when it is really necessary to be very accurate 
(such as filter circuits) and/or when the circuit 
must be as low-noise as possible (a high-end 
audio amplifier) do we use the, more expen- 
sive, metal-film resistors. 


Table 1 lists the colour codes for resistors. A 
1% metal-film resistor with a value of 1kQ has, 
according to Table 1, the colour code brown, 
black, black, brown, brown. Unfortunately, 
in this case it is not immediately obvious in 
which direction the colour code should be 
read — in reverse it could be a resistor of 
110 Q. However, don't give up too soon — 
practice makes perfect and in the event of 
doubt an ohmmeter can be the final arbiter! 


Another disadvantage of the coloured 
bands is that the colours red and orange 





Table 1: Colour code for resistors 















































Value Multiplier Tolerance 
4 bands 1st band 2nd band - 3rd band 4th band 
5 bands 1st band 2nd band 3rd band 4th band 5th band 
black - 0 0 1 

brown 1 1 1 10 +1% 
red 2 2 2 100 +2% 
orange 3 3 3 1k 

yellow 4 4 4 10k 

green 5 5 5 100 k +0,5% 
blue 6 6 6 1M 

violet 7 7 7 10M 

grey 8 8 8 100 M 

white 9 9 9 1G 

gold - - z 0.1 +5% 
silver - - 7 0.01 +10% 








are sometimes difficult to distinguish. In 
case there is any doubt, again, reach for 
the ohmmeter. 


Resistors are (for obvious reasons) not 
produced in every conceivable value. Instead 
they are manufactured in standardised 
E-series. Here the ratio of two consecutive 
values within a decade is more or less the 
same. The E-values are in turn produced 
in different series of decades (for example 
2.2 Q, 22 Q, 220 Q, 2.2 kO, 22 kQ, 220 kQ and 
2.2 MQ). Table 2 shows the most common E 
series values for E3, E6, E12 and E24, where 
the number indicates the number of values 
per decade. For precision applications there 
are the E48, E96 and E192 series, i.e. a total 
of seven standardised E series. 


By the way, there is also an R-series, but the 
probability that you will get involved with 
them in electronics is very low. In electrical 
engineering you will come across R-series only 
in relation to fuses or miniature circuit breakers. 
If you need an extremely precise and, at the 
same time, awkward value that does not occur 
in any of the E series, then it can be achieved 
with an appropriately selected parallel and/ 
or series connection of E24 resistors. Or you 
could use a variable resistor... 


Variable resistors 

Potentiometers, also known simply as a ‘pot; 
and trimpots are resistors whose resistance 
value can be changed. Potentiometers have 
a shaft that protrudes through a hole in the 
enclosure of a device that can be operated 
by the user. The most well-known example 











is, of course, the volume control of an ampli- 
fier (although in the present digital era these 
are now often digital encoders). The there 
are the trimpots that are generally inside the 
device (usually on the circuit board) and are 
intended for once-only adjustment using a 
small screwdriver or special trimming tool. 


Figure 2 shows various examples of (trim) 
pots. On the right you see the slide potenti- 
ometer, or fader, that is often used in mixing 
panels. In the middle are two ordinary poten- 
tiometers with a mono version at the top and 
a stereo version at the bottom. Such a stereo 
potentiometer is really two mono potentiom- 
eters on a common shaft. 


In the rotary potentiometer a sliding contact 
moves back and forth along a carbon track. 
Such potentiometers often start to ‘crackle’ 
after some time due to age and contamination. 
This is extremely undesirable, particularly with 
audio amplifiers. If a particular potentiome- 
ter is not hermetically sealed then a special 
spray cleaner can give temporary relief (with 
the emphasis on temporary). Otherwise you 
can try turning it vigorously from one end to 
the other a few times, but this too will likely 
only be a temporary solution. 


Cermet potentiometers are less sensitive to 
these ageing symptoms (and are therefore 
also more expensive). Figure 2 at the top in 
the middle provides two examples (mono on 
the right and stereo on the left). Finally, at the 
top left of Figure 2, there are two closed-vari- 
ant trimpots that are a little less sensitive to 
dirt and dust ingress. 





Figure 2. Potentiometers and trimpots. 


Table 2: Standard resistor values 













































































E3 E6 E12 E24 
1 1 1 1 
1.1 

1.2 1.2 

1.3 

1.5 1.5 1.5 

1.6 

1.8 1.8 

2.0 

2.2 2.2 2.2 2.2 

2.4 

2.7 2.7 

3.0 

3.3 3.3 3.3 

3.6 

3.9 3.9 

4.3 

4.7 4.7 4.7 4.7 

5.1 

5.6 5.6 

6.2 

6.8 6.8 6.8 

7.5 

8.2 8.2 

9.1 
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Figure 3. Potentiometers: schematic symbols. 
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Figure 5. NTC- and PTC-resistors. 


Figure 6. Light dependent resistor (LDR). 


Linear or logarithmic? 
Potentiometers in parts lists often have the 
abbreviation log or lin in the specification. This 
means logarithmic and linear respectively 
and this indicates how the resistance value 
varies as a function of the angle of rotation. 
Logarithmic potentiometers are mainly used 
as volume controls in amplifiers because 
our hearing has a more or less logarithmic 
characteristic. 


In Figure 3 you can see the schematic symbols 
for potentiometers: a potentiometer on the 
left, in the middle a trimpot, and the equiva- 
lent circuit on the right. The value of each of 
the resistors depends on the position of the 
wiper (the middle connection of the schematic 
symbol). As with ordinary resistors, potenti- 
ometers also have a maximum power rating. 


Special resistors 
There are a whole range of resistors whose 
value is dependent on a specific physical 


Mh 


Figure 4. Voltage dependent resistor (VDR). 


v 


quantity. The most common ones are briefly 
discussed below. 


Figure 4 shows the schematic symbol for a 
Voltage Dependent Resistor (VDR). Once a 
certain voltage has been exceeded, the resis- 
tance of a VDR becomes very low. In this 
way the component can protect other parts 
from over-voltage conditions. VDRs are often 
used to protect power transformers against 
over-voltage (something that could happen 
when the neutral is not connected correctly). 
There will then be enough current through the 
VDR to blow the mains fuse and thus avoid 
further damage. However, the VDR often has 
to be replaced after such failures too. 


In Figure 5 we see several symbols for 
temperature-sensitive resistors. The two 
symbols on the left represent an NTC resistor 
(Negative Temperature Coefficient); the two 
symbols on the right represent a PTC resis- 
tor (Positive Temperature Coefficient). The 
resistance value of an NTC resistor decreases 
as it becomes warmer; with a PTC resistor 
this is, of course, the exact opposite. NTC 
resistors are sometimes used to limit inrush 
currents. In conventional power amplifiers 
there are usually heavy mains transformers 
with large, discharged smoothing capaci- 
tors when powered off. As a result there is 
an extremely large incoming current at turn-on 
that could blow the mains fuse. An NTC can 
help prevent this problem by limiting the initial 
inrush current. As the NTC becomes warmer, 
as a result of the current flowing through it, the 
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Questions or Comments? 

Do you have questions or comments 
regarding this article? Then email 
Elektor at editor@elektor.com. 
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current increases further until it finally reaches 
its nominal value. These current-limiting resis- 
tors are usually bypassed by an (electrome- 
chanical) relay after a few seconds so that no 
more power is lost in the NTC-resistor. 


Finally, Figure 6 shows a Light Dependent 
Resistor (LDR). The resistance value of the 
LDR decreases when the light that falls on it 
becomes brighter. In the past, these resistors 
were often used in optical sensors. However, 
one of their disadvantages is that they are 
relatively slow to react to changes in light 
level. These days photo-diodes or photo-tran- 
sistors are preferred for such applications. 
This brings us to the end of our discussion 
on the topic of resistors. Next time we will 
continue with capacitors. I< 

200551-04 


The magazine article series “Starting Out in Electronics” 


is based on the book Basic Electronics for Beginners by 
Michael Ebner, published by Elektor. 


RELATED PRODUCTS 





Basic Electronics for Beginners 
> Book: wwwelektor.com/13950 
> E-book: wwwelektor.com/18232 





4omebrew CPUs 


The discrete microcontroller 


By Dennis Kuschel (Germany) 


Modern microcontrollers 
make it possible to crama 
whole lot of functionality into 
an extremely small volume. 
Things that, in the past, 
required a bag full of chips 

to accomplish can now be 
realised in a single IC without 
any great difficulty. Of course, 
such a microcontroller still 
needs to be programmed and 
this is often done with the aid 
of high-level programming 





Figure 1: Dennis Kuschel in his home laboratory. The furnishings can be described as almost spartan. 


languages. But this has the disadvantage that the designer can lose the link to what goes on 
at the port or transistor level inside such devices. 


This was also Dennis Kuschel’s train of thought when he began his 
work on building a discrete microcontroller with individual logic 
ICs. Perhaps we should call it a ‘macrocontroller’ really. Here we 
hand over to Dennis: 





“Figure 1 shows my work space at home. I only own a few items 
of measurment equipment — an oscilloscope and two digital 
multimeters. I don’t need anything else and l'm really not missing 
anything either. On my work bench you can see an example of the 
MyNOR computer where I have replaced 10 of the ICs with discrete 
transistor circuits (the cheerfully-coloured jumper wires). 








“For Christmas in 1989 I received my first computer: a Commodore 
64. I quickly wanted to do more than simply play games — I 
preferred to write my own programs and learn how sucha device 
actually works. Four years later (I was then 17) I built a new computer 
from the salvaged parts of a C64 that I then programmed in assem- 
bler. During my electrotechnology studies in the 90s, the idea of 
building a CPU from simple logic gates and ICs came to me. A few 
years later MyCPU [1] was born. This is a computer built from many 
tens of logic ICs from the 7400-series CMOS logic family that runs 
aversion of C64 Basic. 





“The MyCPU received a lot of attention at computer festivals and 
hobby fairs, but many of those who were interested shied away from 


building their own because the cost of the complete MyCPU plus 
peripherals quickly approaches €1,000. That is why I decided (after 
20 years) to begin a new project: a simple and as-cheap-as-possi- 
ble computer that is, of course, entirely built from discrete parts. 
It had to meet two conditions. Firstly, it had to do without an ALU 
(Arithmetic Logic Unit) for the simple reason that the previously 
ubiquitous ALU chip 74LC181 is no longer available and alterna- 








FA Qt 
BS170 





Figure 2: This is the heart of the MyNOR computer: a single, discretely-built 
NOR gate. 


©lektor January & February 2021 41 








4MHz Osc 


32kB ROM 


No CPU. No-ALU: 
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8 Outputs 


1?C + SPI 


16 Outputs 


Figure 3: The final version of MyNOR. The description on the right shows that a considerable amount of functionality is possible. 


tives have become too complicated. And, secondly, it would have 
to suffice with a single programmable memory IC (EEPROM). 


“My new computer uses only a single NOR-gate for its arithmetic 
-an extremely simple logic unit that I chose because it is easily 
built using two MOSFET transistors and a resistor (Figure 2). All 
arithmetical operations (such as AND, OR, EXOR, add and subtract) 
are obtained in software from combining many individual NOR 
operations. 


“Because of the central NOR gate I have christened my new 
computer MyNOR [2]. The total number of parts is so few that the 
entire circuit fits on a circuit board measuring 10 x 13 cm. Figure 3 
shows the formal portrait of MyNOR, while the photo on the right 
shows what is where on the circuit board. It also contains a consid- 





Figure 4: The pocket calculator on the left and, on the right, the MyNOR 
with keyboard and display. 
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erable number of peripherals: a 64 kB EEPROM for ‘mass storage’, 
while 8 digital inputs and 24 digital outputs provide communication 
with the outside world. These 32 I/Os allow the usual interfaces 
(RS232, I2C and SPI) to be realised in software. 


“This single-board computer can achieve a surprising number of 
things. For example, I built a simple calculator in the operating 
system that can be operated via the RS-232 interface. This calcu- 
lator primarily serves as proof that floating-point operations can 
be carried out by a single NOR-gate! Furthermore, the operating 
system contains a simple monitor program that allows assem- 
bly-language instructions to be entered. This way you can write 
your own assembly-language programs directly on MyNOR and 
store them in the EEPROM (this is a bit in the style of the C64). 
But it is, of course, also possible to upload a complete program. 
This is done using a text file that represents the binary program 
in a special format. A little bit of patience is required because the 
connection at 2400 baud is not blindingly fast. 








“It becomes really exciting when this single-board computer is 
used without the umbilical cord to a PC. For this purpose I have 
developed two expansion boards. The first contains 20 pushbut- 
tons, an LED and eight 7-segment displays along with the requisite 
transistors for driving them. The displays and pushbuttons are 
multiplexed in the usual way. I use the ‘pocket calculator’ built in 
this manner every day at work. 


“The second expansion board turns MyNOR into a real small 
computer. This board contains, in addition to the usual pushbut- 
tons, a 4 x 20 LCD, a little loudspeaker, a battery-backed real-time 
clock and a temperature sensor. When MyNOR is expanded with 
this board there are an endless number of possibilities: I have 
already programmed a few games (minesweeper, Tetris), a kitchen 








Figure 5: The toothbrush timer consists of a MyNOR v1.0 plus the 7-segment 
board v1.0. The device underneath the timer is, by the way, a high-end 
receiver (FM and DAB+) with integrated 11-band equaliser and touch 
controls that Dennis built last year. 


TO BE CONTINUED? 


Would you like to know more about DIY CPUs? Let us know 
via editor@elektor.com and perhaps we will devote a more 
comprehensive article to this topic in the future. 


timer, a music box and an I?C-bus scanner. Both expansion boards 
can be seen in Figure 4. 


“The first version of MyNOR on a ‘real’ circuit board was not quite 
perfect. Nevertheless, this version (including the 7-segment expan- 
sion) is still serving a purpose: I converted MyNOR v1.0 into a 
teeth-brushing timer for my children (Figure 5). 


“At the moment I'm busy with the further ‘discretising’ of the 
computer. Because the entire MyNOR computer comprises of 


About the author 


Figure 6: Two ICs implemented using individual transistors. The original ICs 
are also shown for comparison (74HC541 and 74HC74). 


Questions or Comments? 
Do you have questions or comments regarding this article? 
Then email Elektor at editor@elektor.com. 


only 22 ICs, it isa nice challenge to replace the 19 logic ICs with 
discreet transistor circuits. The first experiments toward this goal 
are showing much promise. Figure 6 shows two ICs built using 
individual transistors. 


“By the way, I'm not the only one who is busy with DIY CPUs. Many 
of us have come together in the ‘Homebrew CPU Webring’; a visit 
to their website [3] is certainly worthwhile.” M 
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Connect Your Thermostat 
with ESPHome 


An Attempt at Doing Home Automation the Right Way 





By Clemens Valens (Elektor) 





Home automation done properly is like an invisible hand that gently pushes you up a 
hill. When it’s there, it makes life a bit more comfortable; when it isn’t, you can still climb 
that hill. This article is about designing a thermostat for such a home automation system. 
Automated or not, its traditional user interface always keeps you in control of the room's 


temperature. 


About one year ago, | decided to have a go at home automation. 
My first milestone was the automation of the thermostat in our 
living room. | did this by replacing the existing wall thermostat by 
the Wi-Fi Desktop Thermostat (Elektor project 160269, published 
in Elektor, January/February 2018 [1][2]) that | had reprogrammed 
with ESPHome-based firmware. The new firmware exposed all the 
controls of the desktop thermostat (i.e, one relay, two pushbuttons 
and three LEDs), allowing them to be automated by a home automa- 
tion controller like Home Assistant. 
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In this setup, Home Assistant — running on a Raspberry Pi — plays 
the role of thermostat, meaning that it decides when to turn on or 
off the heater. The desktop thermostat itself has become a simple 
remote-controlled relay with some LEDs. 


Nice, But... 
The system worked fine and helped us comfortably through the winter 
of 2019-2020. However, it had a few inconveniences: 





> Wi-Fi network required; 
> Home Assistant required; 
> Unaesthetic. 


Future Proof 

At the time of doing these experiments the first problem was not 
much of a problem as most of us have a Wi-Fi network running. 
When it stops working, rebooting the router or whatever you have 
usually fixes it. However, as many of us have experienced several 
times in our lives by now, technologies come and go, and so there 
is no guarantee that there will always be a Wi-Fi network around. 
Our homes, on the other hand, are probably still there in thirty 
years’ time or more. In other words, a somewhat future-proof design 
would be desirable. 


Past Proof 

The second point is related to the first as Home Assistant and Raspberry 
Pi may disappear someday too. But there is more. | kind of know how 
to deal with Home Assistant running on a Raspberry Pi, but most 
people | know do not. To allow other people to use my automated 
thermostat, it must be “past-proof” as well. It should look like a classic 
wall thermostat and behave like one. The automation part may not be 
imposed but should be discreetly optional instead. It is there for those 
who want to use it, but for those who don't, it may not be in the way. 


A Matter of Taste 

The third issue is somewhat personal. The automated desktop thermo- 
stat ended up dangling at the end of a length of wire connected to a 
hole in the wall where the old thermostat used to be (Figure 1). A few 
unused mains-connected wires sticking out of the wall were protected 
with bits of isolation tape against silly humans. Also, as the desktop 
thermostat needs a 5 V power supply on a USB connector, it was 
powered by a phone charger plugged into a nearby power strip. This 
meant that there were several very visible wires going to the device 
where the original thermostat had none. Although an excellent conver- 
sation starter, most visitors didn’t think the system looked very nice 


wu 


(but “ugly’ “weird” and “dangerous” instead). 


Back to the Drawing Board 

The shortcomings of the initial desktop thermostat setup made me 
decide to redesign it to solve most and if possible, all of the inconve- 
niences. This resulted in the following specifications: 


> Local, i.e. on-device setting of target temperature; 

> Local control overrules automation; 

> Mains powered; 

> Proper connections and professional-looking enclosure. 


The second item relates to software, the three others concern the 
electronics of the new thermostat. 


Specification 1 implies an intuitive user interface to set the desired 
target temperature. The desktop thermostat has two pushbuttons, 
allowing an up/down control of the target temperature. However, it 
doesn't have a display to visualise it. Adding a display to the limited 
number of I/O pins available on the Wi-Fi module is complicated. 
Using a potentiometer with a calibrated scale like the original thermo- 
stat seemed simpler and is possible thanks to the Wi-Fi module's 
analogue input. 


The third specification requires some thought as well. About 1 W of 
power is needed for a Wi-Fi connection and to power the relay. Building 
a small power supply with a transformer can be done, but it is difficult 
to make it small enough; we do not want a huge box on the wall. The 
original thermostat had a transformerless power supply which is fine 
for relatively constant loads, but | am not sure if it performs well with 
a load running Wi-Fi. My intention was therefore to use a small AC/ 
DC converter module instead. 


Searching through enclosure catalogues | did not find something 
suitable. Creating a good-looking custom enclosure is not my strong 
point, but today with FabLabs, 3D-printing and laser cutting readily 
available even in remote places, this should not be too difficult. Yet | 





Figure 1: Some people felt that this way of installing a smart thermostat in a 
living room was “unaesthetic.” 


didn't go that way. Instead, | decided to try to reuse the enclosure of 
the original thermostat as it had already everything | wanted: a poten- 
tiometer with a scale, an LED and a power switch. Furthermore, it had 
mounting holes in the right places and a good way to connect a PCB 
to the mains through the bottom, hiding all the wires. 


My design effort now boiled down to cramming the redesigned desktop 
thermostat circuit on a circuit board in such a way that it would all 
fit inside the existing enclosure with the potentiometer, LED, power 
switch and mains connector in the exact same positions as in the 
original thermostat. 


Redesigning the circuit of the desktop thermostat was easy enough 
(Figure 2). | replaced the USB power supply by a 5 V AC/DC module, and 
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| added a potentiometer with a voltage limiting resistor because the Wi-Fi 
module cannot handle voltages higher than 11 V. | kept the two pushbut- 
tons and the three LEDs as they might come in handy at some point. 


It was a lucky coincidence that the AC/DC module was just small 
enough to fit under the plastic knob support of the potentiometer. The 
potentiometer, power switch and mains terminal block were recovered 
from the old thermostat (Figure 3). | had to replace the relay by a 5 V 
type as the old thermostats relay was a 48-V type. | did not manage 
to fit the desktop thermostat's relay, but, lucky me once more, the old 
thermostat's relay was a type from an industry-standard family that 
is still available and that exists in 5 V. 


Putting it all on a PCB that fitted in the original enclosure required a 
lot of measuring, but | succeeded in the end. All the SMT components 
including the Wi-Fi module went on the bottom side of the board 
(Figure 4), while all the through-hole parts found a place on the top 
side. A little bit extra board surface was gained by obstructing a couple 
of unused mounting holes of the enclosure. The fitting also implied 
cutting away some plastic obstacles inside the enclosure. To route all 
the tracks, a flexible approach of recommended isolation standards 
was unfortunately unavoidable. 


Software 

The ESPHome firmware that | had compiled for my first setup also 
required rethinking. Instead of simply exposing all the sensors and 
actuators of the thermostat and letting Home Assistant take care of the 
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200519-004 with a new power supply. Also, a 


potentiometer was added for setting 
the target temperature. 


rest, | now had to do automations inside ESPHome. This programming 
and configuring is done in the YAML file of the thermostat's ESPHome 
project (see "Home Automation Made Easy” [3]). 


Measure Room Temperature 

First, declare the temperature sensor that measures the room tempera- 
ture. As the sensor used is a DS18B20 (originally from Dallas, now Maxim 
or even Analog Devices) connected to GPIO pin 5, and since ESPHome 
has a special Dallas component, this translates to the following entries: 


dallas: 
= pin: GPIO5 


sensor: 
= platform: dallas 
address: 0x6D00000C24013928 
name: “Measured temperature” 
id: t_room 
filters: 
= offset: 0:0 


The first line tells ESPHome to include its Dallas 1-wire communica- 
tion module and connect GPIO5 to it. The sensor then is of the dallas 
platform. The address is optional. However, if you specify it, it must 
be correct; you can get it from the ESPHome log (don't use mine, it is 
unique). Specifying an id (t_room, pun not intended) is required here 
because we will need to refer to the sensor from somewhere else inside 








Figure 3: Some parts from the old thermostat were reused in the new 
design. This included the enclosure, which explains the strange shape of the 
new PCB. It also put constraints on the positioning of certain components. 


this YAML file (see below). Adding filters allows for compensating the 
measured temperature in some way if needed. 


Target Temperature 

The target temperature is set with the potentiometer. Add it to the sensor 
section of the YAML file by defining a sensor of the adc platform type as 
the value is a voltage. Using so-called sensor filters, the input voltage is 
converted to a temperature value that corresponds to the scale printed 
on the enclosure. The equation Trarget = 25-Vin + 6.75 fits quite well in my 
case. This translates to a multiply filter with value 25 and an offset filter 
with value 6.75. By specifying the units as °C, an automation controller 
like Home Assistant will treat this data as a temperature. 





Figure 4: Everything SMT is mounted on the backside of the board. The 
traces connected to the heater (right upper corner) were reinforced with 
extra solder to allow them to carry large currents without overheating. 

The slot right below them provides galvanic isolation between the high- 
and low-voltage parts. The black thingy sticking out on the right is the 
temperature sensor, protected by heat-shrink tubing. All the heat-producing 
parts are located on the left side of the board and are supposed to point 
upwards after installation of the thermostat. 


Figure 5: After some minor adjustments of the old thermostat’s enclosure 
(ie, cutting away some plastic), the new board fits snuggly. 


= platform: adc 
name: “Target temperature” 
id: t_target 
icon: “mdi:temperature-celsius” 
pin: AO 
update_interval: 5s 
# Convert potentiometer scale to °C (min=6.75°C, 
max=31.75°C) 
filters: 
= multiply: 25.0 
- offset: 6.75 
unit_of_measurement: 


“oc” 


on_value: 





-A 


Figure 6: Assembly completed. The two pushbuttons are accessible through 
two cut-outs (left) and the sensor sticks out of what is the bottom. The 
green and yellow LEDs are only visible through the ventilation slits to avoid 
lighting the room at night. Using different colours for them makes it easy to 
see which one is turned on. 


(@lektor January & February 2021 47 





then: 

- lambda: |- 
auto call = id(t_controller).make_call(); 
call.set_target_temperature(x); 
call.perform() ; 


The part at the end after on_value: is an automation and will be 
explained after the introduction of the ‘climate’ component below. 
But first, we will look at the relay. 


Switching the Heater 

This is pretty simple as the relay is just a switch connected to GPIO pin 4 
and it is therefore part of the gpio platform. Like the temperature sensor, it 
needs an id (heater) to make it accessible to other parts of the YAML file. 


switch: 

- platform: gpio 
pin: GPIO4 
“Heater” 

id: heater 


name: 


Climate Control 

So, now we have a sensor to measure the room temperature (t_room), 
a potentiometer to set a target temperature (t_target) and a relay to 
switch a heater on and off (heater). 


ESPHome features a climate component to control heating and cooling 
devices. A thermostat therefore is a climate component. The advan- 
tage of using a built-in component is that it saves you work. It will 
also ensure that it gets a nice graphical control widget in the Home 
Assistant user interface. 


climate: 
- platform: thermostat 
“Thermostat” 
id: t_controller 
t_room 
default_target_temperature_low: 20 °C 
heat_action: 
= switch.turn_on: 
idle_action: 
- switch.turn_off: heater 
hysteresis: 0.5 
away_config: 
default_target_temperature_low: 15 °C 


name: 


sensor: 


heater 


The thermostat described in this article does not cool; it can only heat. 
That makes it a member of the ESPHome thermostat platform. It needs 
an id so it can be controlled by other things in the YAML file. | set the 
ID to t_controller because the platform is already called thermostat 
and we don't want to mix things up. 


The climate component has a temperature sensor input, which we 
connect to t_room. It must also be connected to a heater, which we 
can do thanks to the heater switch we defined earlier. 


Like me, you might expect that a climate component also has a target 


temperature input, but it doesn’t. (Maybe it will be added in a future 
version of ESPHome?) Instead it has a set-target-temperature control 
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built in, much like the potentiometer of the thermostat. Fortunately, 
there is a way around this limitation, and that is by using so-called 
‘lambda’ blocks. 


Lambda Blocks 

The concept of lambda blocks is great and terrible at the same time. They 
are great because they let you do whatever you want, or almost, and 
they are awful because they defy the whole concept of device config- 
uration by means of a simple YAML file without having to know C++. 


Simply put, a lambda block is C++ code that is injected into the 
ESPHome project, verbatim. To make this possible, the develop- 
ers had to jump through hoops and loops to come up with a usable 
YAML-to-C++ interface. The result is that lambda code is more compli- 
cated than it would have been, had it been normal C++. 


Actually, as soon as you find yourself using lambda blocks, you should 
start thinking about creating a custom component. ESPHome supports 
custom components for nearly everything. | was on the brink of writing 
a custom climate component to solve the issues | was having but, in 
the end, | decided to keep that subject for another article. 


Back to setting the target temperature of the climate component. 
Its C++ interface has a function to set the target temperature. The 
lambda block in the on_value automation section of the potentio- 
meter sensor above (repeated below) shows how to use it. Every time 
a new value is available, the set_target_temperature method of the 
climate component t_controller is called, like this: 


on_value: 
then: 
- lambda: |- 
auto call = id(t_controller).make_call(); 
call.set_target_temperature(x); 
call.perform() ; 


In normal C/C++ this would have been something like: 


t_controller.set_target_temperature(x) ; 


If the climate component would have had a target temperature input, 
things could have been even simpler. For example: 


climate: 

- platform: thermostat 
“Thermostat” 
id: t_controller 
t_room 
target: t_target 


name: 


sensor: 


Anyway. 


Unfortunately, this way of automating on_value is too simplistic as it 
overrides remote control of the target temperature from e.g, Home 
Assistant. To solve this, the automation should only be allowed to run 
when t_target changes (i.e, when someone turns the potentiome- 
ter). As ESPHome does not have a on_value_changed automation 
for sensors, we can handle this ourselves in the lambda block, like so: 





on_value: 
then: 
= lambda: |= 
static float x_last = 0.0; 
if (x<x_last-0.1 || x>x_last+0.1) 
{ 
x_last = x; 
auto call = id(t_controller). 
call.set_target_temperature(x) ; 
call.perform(); 
} 


make_call(); 


The small hysteresis on x (+01 in this case) improves the immunity of 
the automation to sensor noise. 


The Delta Filter 

Another — nicer — solution is to use the delta filter on t_target. This 
filter only passes a new value if it differs from the previous value by 
an amount of plus or minus delta. So, if delta = 1 and the last value 
was equal to 20, then the next value will only be passed on when it is 
either lower than 19 or higher than 21. 


= platform: adc 
name: “Target temperature” 
id: t_target 


filters: 
= multiply: 25.0 
= offset: 6.75 
= delta: 0.2 


Filters are executed in the order they appear in, meaning that the 
delta filter operates on the value converted to degrees Celsius, and 
not directly on the input voltage. Its value should be small, otherwise 
itis difficult to nudge the thermostat up or down just a little bit, which 
makes all the difference in user comfort. 


Finalising the Device 

With the YAML configuration file ready, the firmware can be uploaded 
to the Wi-Fi module. The first time (i.e, with a module that is not yet 
running ESPHome-compatible software) the serial port must be used 
for this (available on header K2). Refer to [3] for the exact proce- 
dure. Once the device is executing ESPHome with Over-the-Air (OTA) 
programming enabled (when the YAML file contains the line ota:), the 
thermostat can be reprogrammed without being physically connected 
to the development system. In other words, it can be installed in place 
of the existing thermostat. 


The thermostat is mounted so that its temperature sensor is not heated 


— WEB LINKS 


by the Wi-Fi module and the power supply. 


Conclusion 
This article showed how an existing “dumb” thermostat can be replaced 
by a home-made smart and connected one suitable for home automa- 
tion. Cobbling up a prototype that roughly does what it is supposed to 
do was not too difficult; turning it into something that can be used by 
anyone at any time and that is aesthetically acceptable required some 
more effort. No doubt the new thermostat will need some fine-tuning, 
but since it can be programmed remotely (in-the-field, as they say), 
this is easy todo. M 
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Questions or Comments? 

Do you have questions or comments about his article? Email 
the author at clemens.valens@elektor.com or contact Elektor 
at editor@elektor.com. 
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Developer's Zone 


Tips & Tricks, Best Practices 
and Other Useful Information 


By Clemens Valens (Elektor) 


High-side or Low-side Switching? 

In systems employing high-side switching, the switch is inserted 
between the positive power line and the load. Low-side switching 
by contrast connects the load to ground (Figure 1). The principles 
of operation of high-side and low-side switching are easy enough 
to grasp, but when do you prefer one method over the other? It's 
all application dependent for sure. 


4 


Figure 1: Switch a load to 
the supply rail (left) or to 
ground (right)? 


Load 


\ 


Load 


Avoid Dangerous Situations 
High-side switching (Figure 2) is the preferred switching technique 
in situations where short circuits to ground are likelier to occur 






Controller , , ; 
Figure 2: High-side 


1 switching is preferred when 


= the risk of a short circuit 
Load 


to ground is higher than a 
short circuit to the supply. 
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than short circuits to the positive power line. Think for instance 
of cars or machines where most of the structure is connected to 
ground. In such cases it is safer to disconnect the load from the 
battery than from ground. Also, in humid environments, this 
usually results in less connector corrosion as the load carries no 
voltage in the off state. 


Power Switching Is Better With N-Type Devices 

Because N-type transistors in general can carry more current than 
P-types, they are preferable for switching heavy loads. Low-side 
switching with N-type devices is easier than high-side switching 
and can often be done by microcontroller ports without the need 
for special drivers. 


Using an N-type transistor for high-side switching is possible but 
requires a control voltage higher than the (load) voltage connected 
to its source or emitter. To pull the gate or base of the transistor above 
its source or emitter voltage, some sort of charge pump is needed or 
an extra supply. This complicates the design, not only making it more 
expensive but also increasing its sensitivity to noise and interference. 


Driving such a high-side switch with a PWM signal to control e.g., 
the speed ofa motor or the brightness of an LED can be problem- 
atic because of the charge pump. 





Figure 3: Low-side 
switching is cheap and 
easy. However, when a fuse 
must be added because the 
distance between the load 
and the controller is too big 
(right), this configuration 
can become more 
expensive than high-side 
switching. 


Controller 








A Fuse Can Make the Difference 

Thus, low-side switching tends to be cheaper than high-side switch- 
ing. However, when the load and its controller are not located 
closely to each other, efficient system wiring may impose separate 
fuses for the load and its controller instead of just one that protects 
both (Figure 3). High-side switching would only need one. This may 
seem futile, but when you take into account the wiring and work 
required to make a fuse accessible in a fuse box, having to add one 
may very well annihilate the cost advantage of low-side switching. 











Good Ground Is Good 
Low-side switching has one ground connection for both the load 
and its controller. This avoids ground potential differences (ground 





shifts) between the two when currents are high, and the controller 
and load are not close to each other. Low-side switching therefore 
is more robust to ground noise than high-side switching. 

On the other hand, a switch, when closed, introduces a small resistance 
in series with the load. This results in a small voltage drop, meaning 
that the load’s ground is slightly above the controller's ground. 


So, What Do I Do? 

In cases where a (heavy) load only must be switched on or off, 
high-side switching is the preferred method. When the power to 
a load must be controlled through (relatively) high-speed PWM, 
for instance in a lighting or heating system, low-side switching is 
recommended. 


LOW-SIDE OR HIGH-SIDE CURRENT SENSING? 


A problem similar to high-side and low-side switching is current 
sensing. Several techniques for sensing currents in a circuit 
exist, but probably the most common one is to place a small 
resistor of a known value in series with the load. Since the 
current through the load and the series resistor is the same, 
Ohm's law lets you calculate the current by first measuring 

the voltage over the series resistor and then dividing it by 

the resistor's value. The question that now arises is: where to 
connect that resistor? Before or after the load? In other words, 
high-side or low-side current sensing? 


Risanee Load 


High-side versus low-side 
current sensing. 


Load Ronse 


Low-Side Current Sensing Is Cheap 

In the case of low-side current sensing, the typically small 
voltage over the sense resistor is referenced to ground and can 
be amplified with low-cost, low-voltage op-amps before being 
digitised and processed further by for instance a microcontroller. 
However, like the switch in low-side load switching, the sense 
resistor introduces a small voltage drop that lifts the load from 
system ground, possibly resulting in noise and ground bounce. 


Also, low-side current sensing cannot detect if the load is 
shorted to ground, either internally or at one of its terminals. 


Handle High Common Mode Voltages 

High-side current sensing does not suffer from these 
shortcomings, but it comes with its own issues. For instance, 
the voltage difference over the sense resistor is not referenced 
to ground. Re-referencing it to ground requires extra circuitry, 
making the system more expensive and complex. 


Furthermore, the amplifier must be capable of coping with a 
common-mode voltage all the way up to the positive supply 
(and even higher in case of transients), which can be hundreds 
of volts in certain applications. Therefore, the amplifier must 
either support a high supply voltage or have inputs that can 
handle such high common-mode voltages. Also, keeping 
common-mode voltage errors low implies the use of precision 
parts, which is more expensive. 


To make the circuit designer’s life a bit easier, several 
semiconductor manufacturers have added dedicated high-side 
current sensing ICs to their product catalogue. 


Conclusion? 

The current sense method to choose depends on the application 
(again). High-side current sensing can detect if the load is 
shorted or open, and the load remains referenced to ground. 
However, due to the common mode requirements, it is more 
complex and more costly than low-side sensing. Opting for a 
dedicated current sensing IC may be the best way forward. 
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And then there are half H-bridges that require both a high-side 
and a low-side switch... and PWM... Therefore, as always, before 
settling on any technique, make sure that it is a valid choice for 
your application. M 
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Questions or Comments? 

Do you have questions or comments about his article? Email 
the author at clemens.valens@elektor.com or contact Elektor 
at editor@elektor.com. 


TWO METHODS FOR HIGH-SIDE CURRENT SENSING 


Basically, the current sense amplifier (left) divides the current 
through Reense by a factor of R1/Rsense (= 1,000) and forces it 
through R3. The voltage over R3 therefore is proportional to the 
current through Reense: A current of 1A through Reense produces 
a current of 1 mA through R3 (1 kQ), resulting in a voltage of 1V 
over R3. 


The difference amplifier (right) multiplies the 
voltage over Reense by R4/R2 (= 10). A current 
of 1 A through Reense Produces a voltage of 0.1 V 
over Rense Which, amplified by 10, results in 1 V 
at the output of the op-amp. 


Both circuits produce the same output, yet they 
are not equivalent. 


Bandwidth 

First, the bandwidth of the two circuits is not 

the same. The difference amplifier usually has a 
(much) lower bandwidth than the current sense 
amplifier and is therefore more suitable for 
measuring the average current flowing through 

a load. The current sense amplifier, on the other 
hand, is fast and can measure instantaneous load 
current at high frequencies. 


CMR 

Another important factor to consider is common-mode 
rejection, or CMR. As the common mode voltage at the inputs is 
high, even a small asymmetry between the two inputs will result 
in an error at the amplifier's output. The difference amplifier 
therefore needs high-precision resistors to keep the CMR error 
as low as possible. In the current sense amplifier, it is mainly 
the opamp that determines CMR, a parameter controlled by its 
manufacturer. 


Robustness 

On the other hand, thanks to its external resistors, a difference 
amplifier can more easily be adapted to very high common 
mode voltages than the current sense amplifier. This brings 

us to the subject of robustness of the current sensing circuit. 
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If transients producing out-of-bounds voltages over the sense 

resistor can be present, the difference amplifier is protected by 
its high-value resistors. In such cases the current sense amplifier 
must mainly rely on any input overvoltage protection circuitry 
built into its opamp. Similarly, a difference amplifier is usually 

also more robust in the case of an inverted supply. 





Several methods exist for doing high-side current sensing. The current sense amplifier 
and the current shunt monitor or difference amplifier shown here are two of them. 


Power Consumption 

Finally, there is power consumption, especially important in 
(ultra) low-power applications. If connected directly to the 
supply, the difference amplifier with its resistors will always 
consume some current even when the opamp is unpowered. 
The current sense amplifier features a much higher input 
impedance, which helps making batteries last longer. 


Special ICs 

Because of all these subtleties, semiconductor manufacturers 
sell special current sensing ICs based on different topologies, 
making it much easier for designers to add current sensing to 
their applications. 


MINI PROJECTS 
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Small Circuits Revival 


From the Elektor suggestions box 


Compiled by Eric Bogers (Elektor) 


No appetite for tackling a big project? That’s fortunate because here we have a few more 
small circuits that are easy to build and perfect for keeping those ‘January blues’ at bay... 


= XT )- idea: Peter Neufeld (Germany) 


Tranquili-T 

The big ideas and projects resulting from the 
efforts of an electronics enthusiast are, unfor- 
tunately, not noticed by friends and family — 
that DIY oscillator or servo controller can't 
really be called a crowd pleaser. However, 
the soothing Tranquili-T by Mr. Neufeld has 
received much praise, resulting in him build- 
ing several devices to give to friends and 
acquaintances. 


The circuit (see Figure 1) is built around a 
cheap MP3 player loaded with soothing music 
or, for example, the sound of surf or birds. 
The soothing effect is then amplified with a 
rainbow LED that provides subdued lighting 
in a dark room. A video from the author shows 
the Tranquili-T in action [1]. 


We can be brief about the power supply: 
anything that supplies 4.5 to 5.0 V can be 
used. For example, three 1.5 V batteries 
are an option, but remember that the LED 
draws around 20 mA and the player draws 
a further 50 mA at an average sound level. 
A USB power bank is a good option, as then 
you don't have to worry about dead batteries. 


MP3 players with integrated Class-D ampli- 
fiers are preferred for simplicity. The author 
has had good experience with the JQ6500 
and the DF player Mini. These are available at 
reasonable prices from the usual suppliers in 
the Far East. Figure 1 shows two approaches 
for implementing the volume control outlined 
in seperate boxes. The variant using S2 and S3 
uses two digital inputs; the variant using S4 
and S5 uses a single analogue input in combi- 
nation with two different resistors. The values 
drawn in the diagram apply to the JQ6500. 


Some experimentation may be required here, 
supported by information from the datasheet 
and the Internet, with other MP3 players. 


With respect to the choice of loudspeaker, 
select a model that is as small and flat as 
possible with a load capacity of at least 0.5 W 





R3 





and an impedance of 8-32 Q. (It turned out 
that the volume was too high when using a 
4 Q speaker.) Figure 2 shows the ‘guts’ of a 
version built around the DFPlayer Mini while 
Figure 3 shows a completed Tranquili-T in 
all its glory. 
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Figure 2: The electronics can be built compactly 
on a small piece of prototyping board. 


Figure 3: The final Tranquili-T in all its glory. 
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5...15V 




















Figure 4: Basic circuit of a pulse oscillator based 
on a modified Schmitt trigger. 


{ XÍ Y- idea: Andrey M. Shustov (Russia) 
and Michael A. Shustov (Germany) 


Three shades of Schmitt trigger 
oscillator 

Schmitt triggers or asymmetrical emitter-cou- 
pled triggers can be used to construct simple 
wide-range pulse oscillators. Transforming a 
Schmitt trigger device into a oscillator is quite 
simple. The output of the trigger is connected 
back to the input by a resistor and a capacitor 
is connected between the input of the trigger 
and the common supply rail. 


Figures 4, 5 and 6 show practical circuits 
of pulse oscillators, based on the modified 
Schmitt trigger. A bridge circuit consisting of a 
resistive divider, where the emitter of the input 
transistor is connected to the mid-point of a 
resistive divider, and a time-setting RC circuit, 
formed by the additional hookup elements, 
all act to convert a trigger into a repetitive 
pulse oscillator. 


The p-n transition of the transistor lies 
between the diagonally opposite pair of 
connections of the bridge. When capac- 
itor C1 is discharged, transistor T1 blocks 
and transistor T2 conducts. The voltage 
across then capacitor rises again. Once it 
exceeds the voltage of the mid-point of the 
resistor-divider's mid-point by several volts, 
input transistor T1 conducts again, turning 
T2 off. This de-energises the resistor-di- 
vider and the time-setting capacitor C1 is 


7...16V 











Figure 5: Second variant of a pulse oscillator 
based on a modified Schmitt trigger. 


discharged. Transistor T1 turns off again due 
to the discharge of capacitor C1 and thus 
switches on transistor T2. The process is then 
repeated endlessly. 


The oscillation frequency of the pulse oscil- 
lator in Figure 4 can be changed propor- 
tionally by adjusting the capacitance of 
capacitor C1, Potentiometer R5 permits 
a frequency range greater than 1:10 to be 
covered. LED1 provides a visual feedback 
of the frequency tuning. The LED is at its 
brightest at the beginning of the range and 
is least bright at the end of the range. The 
oscillator operates over a frequency range 
of 3 to 30 Hz. Using the values shown in 
the circuit, the current through LED1 varies 
between 20 and 2 mA at a supply voltage of 
9 V. When the supply voltage is varied from 
5 to 15 V, the oscillation frequency changes 
by no more than 10%. 


The pulse oscillators in Figure 5 and 
Figure 6 also operate at a nominal supply 
voltage of 9 V across the frequency range 
0.8 to 10 kHz and 0.35 to 2.8 kHz respectively. 
The oscillator in Figure 5 is controlled by 
changing the ratio of the resistive voltage 
divider arms (resistors R4, R5 and R6, the 
right half the bridge circuit). The opera- 
tion mode of the oscillator in Figure 6 is 
controlled by resistor chain R2, R3 and R4 
that regulate the discharge/charge processes 
in the left half of the bridge circuit. 
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Figure 6: And finally a third variant; here the 
pulse duration can be controlled. 


Laer 


(xf )- idea: Elektor Labs 


Wandering mono audio 

Before digital signal processing entered 
the scene, musicians had to use ingenious 
electromechanical contraptions to create 
certain sound effects. Take the Hammond 
organ, the electromechanical precursor of the 
synthesiser (somewhat succinctly expressed), 
an instrument that musicians like Walter 
Wanderley used to create delightful sounds. 
There was, however, one drawback: such an 
organ was mono. This resulted in a rather 
feeble sound eminating when on stage in front 
of an audience. 


Fortunately there was Donald Leslie who 
developed a particularly clever solution to 
this problem. He came up with the idea that 
a rotating loudspeaker could ‘swing’ the mono 
sound around the room, creating a much 
wider sound image. Due to the moving parts, 
a rotating loudspeaker is difficult to achieve 
electrically. The Leslie loudspeaker solved this 
by mounting a rotating cylinder with a sound 
hole horizontally above the loudspeaker — 
more or less as sketched in Figure 7. 


Here we treat you to a (very, very simple) 
electronic equivalent that may not match 
the quality of an original (and very expen- 
sive) Leslie speaker, but it remains interesting 
enough for your own experiments. Figure 8 
shows the schematic. 





On the left is a discretely-con- 
structed astable multivibrator, 
the frequency of which can be 
set with P1 to between approx- 
imately 1 Hz and 8 Hz. Note: P1 
is a linear stereo potentiometer; 
its wiring is shown in the centre 
of Figure 8. The two light bulbs 
serve primarily to vary the resis- 
tance of the LDRs R3 and R4 and 
also act as collector resistors for 
the two transistors. 


We come to the diagram on the 
right of Figure 8. A mono signal 
(not a stereo signal!) comes in 
at C3 and is split by P2 (which 
immediately acts as a kind 
of balance control) into two 
branches that go to the Land R 
inputs of a stereo amplifier. Due to 
the light-sensitive resistors, part of 
the mono signal for each channel 
is dissipated to ground; how much 
depends of course on the resis- 
tance value of the LDR and this, 
in turn, depends on the amount 


P1=2x 10k lin. 


rotating 
cylinder 


sound 
hole 


loudspeaker 





Figure 7: The Leslie-box is a horizontally mounted 
loudspeaker with a rotating cylinder that contains a sound 
hole. 


of light that falls on it. The amount of 
light varies periodically thanks to the 
astable multivibrator. It will now also 
be clear why we use incandescent 
bulbs and not LEDs: an incandescent 
bulb has a certain inertia that makes 
the resistance change (and therefore 
the change of the signal from left to 
right and back) more smooth. 


The construction of our pseudo-Leslie 
is not critical. Only the lamps must be 
mounted in such as way so that they 
are close to their corresponding LDRs. 
Here the use of a light-tight tube 
ensures that ambient light cannot 
throw a spanner in the works. M 

200557-04 


Questions or Comments? 
Do you have questions or 
comments regarding this 
article? Then email Elektor at 
editor@elektor.com. 





Figure 8: The circuit (left) is relatively simple. The wiring for the potentiometer is shown in the centre. The connection to a stereo amplifier is shown on the 


right. 


= WEB LINKS 


[1] Video of Tranquili-T in action: https://vimeo.com/272785420 





[2] Donald Leslie, Wikipedia: https://en.wikipedia.org/wiki/Donald_Leslie 
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Raspberry Pi Full Stack 


RPi and RF24 at the Heart of a Sensor Network 


Raspberry Pi 
Full Stack 





The Raspberry Pi will act as the base node of the RF24 network and 
is responsible for processing the sensor values it receives from the 
Arduino node (or nodes, if you have more than one). [The Arduino 
node is described in preceding chapters in the book not excerpted 
here, Ed.]. In this chapter, I will show you how to connect the RF24 
module to the Raspberry Pi. You can choose to do the wiring on 
a breadboard, or to use a special HAT I designed for this purpose. 
limplemented my Raspberry Pi RF24 module using the HAT break- 
out. You can see it in action in Figure 1. The HAT accommodates 
the nRF24 transceiver module, the DHT22, a momentary button, 
and two LEDs (power indicator, and activity indicator). You can 





Figure 1: The Raspberry Pi HAT installed on a Raspberry Pi Zero W. 
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By Dr. Peter Dalmaris (Australia) 


This installment of Elektor Books presents roughly two 
chapters excerpted from Peter Dalmaris’ book Raspberry Pi 
Full Stack recently published by Elektor. Aimed at inquisitive 
RPi users keen to link hardware and software on their learn- 
by-doing journey, the book has a wealth of educational 
material to offer. Here's a ‘day trip’ described in fine detail: 
combining an RPi with an RF24 module to read values from 
remote sensors incorporated in a small network. 


download the Gerber files for the HAT from the project's part list 
page [1]. You can also order this PCB directly from PCBWay [2]. 


If you prefer to prototype this circuit using the breadboard, please 
consult the connections table in Figure 2, and the schematic 
diagram of the HAT PCB in Figure 3. You can get a high-resolution 
version of the HAT schematic from the same project parts list [3]. 


In the following list I include all the parts that you will need to 
implement that schematic diagram of Figure 2. With some of 
these parts, such as the button and DHT22 sensor, you have already 








Raspberry Pi - RF24 - DHT22 


DHT22 





Raspberry Pi nRF24 Comments 


3.3V Vee Pin 1 - Power 220uF elec. cap pin “+”. 
GND GND Pin 4- GND 220uF elec. cap pin “-". 
GPIO 11 SCK 
GPIO9 MISO 
GPIO 10 MOSI 
GPIO 8 CSN 
GPIO7 CE 
GPIO4 (Pin 7) Pin 2 - Data Adai $ 10KOhm pull up resistor between Data and 


Raspberry Pi Full Stack E rations 


Figure 2: The connection details for the nRF24 and DHT22 modules. 
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Figure 3: The schematic diagram of the Raspberry Pi HAT for the nRF24 and DHT22 breakout. 


connected in earlier parts of this project. If you are working your 
way through the project, the only new components are the nRF24 
transceiver and its bypass capacitor. 


Parts needed: 

> one DHT22; 

> one nRF24 breakout; 

> two resistors, 10 kQ; 

> two resistors, 330 Q; 

> one LED, red (power indicator); 

> one LED, blue (activity indicator); 

> one electrolytic capacitor, 220 uF or similar. 











The Raspberry Pi nRF24 receiver script 

In this chapter, I will explain the functionality of the Python receiver 
script that runs on the Raspberry Pi and takes care of the nRF24 
communications. Note this script will not work ‘out of the box’. 
It depends on the RF24 and RF24Network C-language drivers and 
the Python wrappers that I will show you how to set up in the next 
chapter. For now, let's concentrate on the Python receiver script. You 
can download and then view the full source code of this script in the 
project repository [4]. I have written this script so that eventually 
it can run as a background process controlled by systemd (similar 
to the way you already set up the web application script earlier in 
this project). I will show you how to do this later, as first we must 
be sure the script runs properly on the command line. 














The content of the function log_values() is an almost perfect 
copy of the same function in script env_log.py that is already set 
to run based on a Cron schedule. This function will simply receive 
sensor values as parameters and store them in the local database 
and Google Sheet on the Cloud. 





Below I list and discuss selected elements of the script, in particular 
those that relate to the RPI-nRF24 communications. 





> Right after the definition ofthe log values() function, the 
script sets up the nRF24 module. It first initializes the radio 
variable using the RF24 constructor. This constructor is part of 
the RF24 Python wrapper library that allows us to use the RF24 
C driver from within our Python script. You can learn about 


this function by studying the driver's source code [5]. 


> Once the radio object is created and initialized, the script 


> 


> 


> 


> 


creates the network object using the RF24Network construc- 
tor. This is the object that makes it possible for the Raspberry 
Pi to receive a transmission from the Arduino node. The only 
parameter needed to create the network object is the radio 
object we created on the previous line. You can learn more 
about the RF24Network constructor in the source code of 
RF24Network.h [6], on line 373. 

On the next line, with octlit = lambda n: int(n, 8) we 
create a lambda function which we use later to convert a 
decimal number into an octal number. We do this because 
the RF24 Network driver uses the octal system for the node 
addresses. In Python, a lambda function [7] is similar toa 
regular function (where you use the def keyword) but has 

no name. They are convenient to use when you want to do 
things like evaluate a single expression, as is the case here: we 
pass a decimal number to octlit, and the lambda function 
will return its octal-base equivalent using the Python int() 
function [8]. 
nthis_node = octlit("00"), we use the octlit lambda to 
get the octal-base equivalent of 00, and store the value in the 
this_node variable. This is the RF24 network address of the 
Raspberry Pi. 

n the next six lines, until the whi le block, the script will: 
start the RF24 radio; 

- wait for 0.1 seconds for the radio to become ready; 

start the network at channel 90; 

print the radio and network configuration to the console; 
- reset the packets_sent counter to zero; 

and reset the Llast_sent counter to zero. 

Now the radio and network are ready, the script enters an 
infinite loop during which it waits for a transition from an 
Arduino node. 

At the start of each loop, it calls the update() function [9] of 
the network object. This checks for your messages. 

f there is no new message, the script goes to sleep for 
1second. After this the loop restarts. 

f there is a new message, the script uses the read() function 
[10] to read the 12 bytes (the payload) of the message, and pass 
them the payload variable. The read function will also get 
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Payload length 


Payload raw content 
Temperature, humidity 
extracted from payload 





Figure 4: Example RF24 receiver script output. 


the header of the message and pass it to the header variable. 
Remember in the Arduino sketch, we created a 12-byte 
payload that looks like this: 51.23,23.09. 
> On the next two lines, I use print to print out the payload to 
the console. This was useful as I was working to decode the 
payload into numbers in the try block that follows. 
> The payload variable contains a string, that looks like this: 
51.23,23.09. The script uses decode () [11] to convert it 
into a UTF-8 encoding, and the split() function [12] to slip 
the temperature and humidity values into an array of two 
substrings, using the ‘’ as the delimiter. The two values are 
stored in the values variable (an array of strings). 
> Inthe try block, the script uses the float () function [13] to 
extract the numbers stored in the payload character array 
and convert them into a floating point number. The float () 
function receives a string, and if it can be converted into a 
number, it returns it. 
> With float (values[1][0:5]), the script takes the first 
5 characters of the string stored in index 1 of the values array, 
and uses the float() function to convert it into a number. 
This is the numerical value stored in the temperature 
variable. 
> The same happens with the humidity value using 
float(values[0][0:5]). 
> Ifany of these two conversions fail, the try block exits and an 
error message is printed on the console. A conversion can fail 
if the payload string is not formatted properly by the Arduino, 
or perhaps the payload becomes corrupted during trans- 
mission and receipt. Interference may be the cause of such 
corruption. 





























Take as much time as you need to study this code, so you are 
comfortable with it. When you are ready, copy it into your 
application directory. Use Vim to create a new file titled ‘rf24_ 
receiver.py’. In the vim buffer, copy the code from the project 
repository [14]. 








Before you can test the RF24 communications, you need to 
compile the RF24 and RF24Network C language drivers and 
Python wrappers. You will do this in the next chapter. But 
before you do this, I want to show you what the script you just 
learned looks like when running (Figure 4). I have annotated 
this screenshot so you can see the printouts embedded in the 
script. Let’s continue to the next chapter with the setup of the 
RF24 and RF24Network drivers. 
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Once you have assembled the circuit, continue to the next chapter 
where you will implement the Python script that handles the nRF24 
communications. 


How to install the Python nRF24 modules 

on the Raspberry Pi 

In this chapter I will show you how to compile and install the 
C-language drivers and relevant Python wrappers for the nRF24 
module. There are two modules involved: the main RF24 module, 
and RF24Network sub-module. There are several forks of the RF24 
project, but the one you will be using is maintained by TMRh2o 
[15]. This is optimized for the Raspberry Pi. 








You can obtain the source code for the two modules from their 
respective Github repositories: 





> RF24 repository: https://github.com/nRF24/RF24; 
> RF24Network repository: https://github.com/nRF24/ 
RF24Network; 








For each module, the installation process includes these steps: 





> download the source code of the module from Github; 
> compile and install the C driver; 
> compile and install the Python wrapper. 





Before you begin, ensure the SPI interface on your Raspberry Pi 
is enabled. The nRF24 module uses SPI to communicate with 
the Raspberry Pi. To check this (and enable SPI if not already 
enabled), log in to your Raspberry Pi and type the following on 
the command line: 


sudo raspi-config 
Use the keyboard arrows and Enter key to navigate to Interfacing 


Options, and then SPI. Enable SPI if necessary, and exit raspi-con- 
fig. Continue by updating Raspbian: 








sudo apt-get update 
sudo apt-get upgrade 


You will download the source code of the modules in your applica- 
tion directory. You also want to compile the Python wrappers with 
your application Python virtual environment activated so that they 
are available to your application Python scripts. 


Prepare your work with these commands: 
$ sudo su 

# cd /var/www/lab_app/ 

# . bin/activate 

# mkdir rf24libs 

# cd rf24libs 

You are now ready to begin the compilation and installation of 
the two modules. 


RF24 compilation and installation 
Create a clone of the RF24 source code, from the git at 
https://github.com/tmrh20/RF24. 





(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs# git clone 

https://github.com/tmrh20/RF24.git RF24 

Cloning into 'RF24'... 


remote: Enumerating objects: 46, done. 
remote: Counting objects: 100% (46/46), done. 
remote: Compressing objects: 100% (41/41), done. 


remote: Total 3545 (delta 16), 
pack-reused 3499 

Receiving objects: 100% (3545/3545), 1.54 MiB | 
679.00 KiB/s, done. 

Resolving deltas: 100% (2119/2119), done. 


reused 15 (delta 4), 


In your source code directory, you now have a new directory: 
‘RF24’. 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs# ls -al 

total 12 

drwxr-xr-x 3 root root 4096 May 13 01:38 . 

drwxr-xr-x 14 root root 4096 May 13 01:39 .. 

drwxr-xr-x 9 root root 4096 May 13 01:38 RF24 


Enter the RF24 directory and install the driver: 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs# cd RF24/ 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24# make install 

[Running configure] 

[SECTION] Detecting arm compilation environment. 

[OK] arm-linux-gnueabihf-gcc detected. 

[OK] arm-linux-gnueabihf-g++ detected. 

. (omitted output)... 

[Installing Libs to /usr/local/lib] 

[Installing Headers to /usr/local/include/RF24] 


The C driver is now installed. Let's work on the Python wrapper. 
This operation can take several minutes on the slower Raspberry 
Pi Zero W. 


(lab_app) root@rpi4:/var/www/lab_app/rf24libs/RF24/ 
pyRF24# cd pyRF24/ 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24/pyRF24# 

python setup.py install 

running install 

running bdist_egg 

running egg_info 

creating RF24.egg-info 

« (omitted output)... 

Installed /var/www/lab_app/lib/python3.8/ 
site-packages/RF24-1.3.4-py3.8- 

Linux-armv6l.egg 

Processing dependencies for RF24==1.3.4 

Finished processing dependencies for RF24==1.3.4 


The RF24 module is now installed, and the Python wrapper is ready 
to use. Continue with RF24Network. 


RF24Network 


Go back to the root of the rf23libs directory and create a clone of 
the RF24Network source code, from https://github.com/nRF24/ 
RF24Network. git. 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24/pyRF24# cd 

bil Gi 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs# git clone 

https://github.com/nRF24/RF24Network. git 

Cloning into 'RF24Network'... 

remote: Enumerating objects: 2249, done. 

remote: Total 2249 (delta 0), reused © (delta 0), 
pack-reused 2249 

Receiving objects: 100% (2249/2249), 1.60 MiB | 
733.00 KiB/s, done. 

Resolving deltas: 100% (1342/1342), done. 


The cloning operation has created a new directory, “RF24Network”. 
Change into the new directory and compile the source code: 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs# cd RF24Network/ 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24Network# make 

install 

g++ -Wall -fPIC -c RF24Network.cpp 

g++ -shared -Wl,-soname, librf24network.so.1 -o 
librf24network.so.1.0 

RF24Network.o -lrf24-bcm 

[Install] 

[Installing Headers] 


The driver is installed. Continue with the Python wrapper for 
RF24Network. 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24Network# cd 

. ./RF24/pyRF24/pyRF24Network/ 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24/pyRF24/ 

pyRF24Network# python setup.py install 

running install 

running build 

running build_ext 

building 'RF24Network' extension 

« (omitted output)... 

running install_egg_info 

Removing /var/www/lab_app/lib/python3.8/ 
site-packages/ 

RF24Network-1.0-py3.8.egg-info 

Writing /var/www/lab_app/lib/python3.8/site-packages/ 

RF24Network-1.0-py3.8.egg-info 


The Python wrapper RF24Network is installed. Let's test it. 


Testing 

The easiest way to test that the RF24 and RF24Network modules are 
working properly is to run the Python example programs that ship 
with the source code. You will find these examples in the examples 
directory of pyRF24Network. Run the ‘rx’ example like this: 
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RASPBERRY PI FULL STACK 


Raspberry Pi Full Stack will take you on a whirlwind tour of full-stack web application 
development using Raspberry Pi. In addition to learning how to build an application 
Raspberry Pj from the ground up, you will gain experience and know-how of technologies including: 


Full Stack 


The Linux operating system and command line. 

The Python programming language. 

The Raspberry Pi General Purpose Input Output pins (GPIOs). 
The Nginx web server. 

Flask Python web application microframework. 

JQuery and CSS for creating user interfaces. 

Dealing with time zones. 

Creating charts with Plotly and Google Charts. 

Data logging with Google Sheet. 

Developing applets with IFTTT. 

Securing your application with SSL. 

Receiving SMS notifications to your phone using Twilio. 


Dr, Peter Dalmaris 


LA a a a a A i a a ed 





This book will also teach you how to set up a remote wireless Arduino sensor node and 
collect data from it. Your Raspberry Pi web application will be able to process Arduino 
node data in the same way it processes data from its onboard sensor. 


Raspberry Pi Full Stack will teach you many skills essential to building Web and Internet of Things applications. The application you 
will build in this project is a platform that you can extend upon. This is just the start of what you can do with a Raspberry Pi and the 
software and hardware components that you will learn about. This book is supported by the author via a dedicated discussion space. 


Hard copy: www.elektor.com/raspberry-pi-full-stack 
E-Book: www.elektor.com/raspberry-pi-full-stack-e-book 


(lab_app) root@raspberrypi-zero:/var/www/lab_app/ (lab_app) root@raspberrypi-zero:/var/www/lab_app/ 
rf24libs/RF24/pyRF24/ rf24lLibs/RF24/pyRF24/ 

pyRF24Network# cd examples/ pyRF24Network/examples# python helloworld_rx.py 

(lab_app) root@raspberrypi-zero:/var/www/lab_app/ ================ SPI Configuration ================ 
rf24libs/RF24/pyRF24/ CSN Pin = CEO (PI Hardware Driven) 

pyRF24Network/examples# ls CE Pin = Custom GPIO22 

helloworld_rx.py helloworld_tx.py Clock Speed = 8 Mhz 


— WEB LINKS 


[1] Gerber files for RF24 HAT board: https://techexplorations.com/parts/rpifs-parts/ 


[2] HAT PCB (unpopulated) from PCBWay: 
www.pcbway.com/project/shareproject/Raspberry_Pi_Full_Stack_RF24_and_DHT22_HAT.html 





[3] High-resolution version of schematic: https://techexplorations.com/parts/rpifs-parts/ 

[4]  rf24_receiver.py script source code: https://github.com/futureshocked/RaspberryPiFullStack_Raspbian/blob/master/rf24_receiver.py 
[5] See line 137 of RF24.h: https://github.com/nRF24/RF24/blob/master/RF24.h#L137 

[6] See line 373 of RF24Network.h: https://github.com/nRF24/RF24Network/blob/master/RF24Network.h#L373 

[7] Learn about ‘lambda expressions’ : https://docs.python.org/3/tutorial/controlflow.html#lambda-expressions 

[8] Learn about ‘int()' : https://docs.python.org/3/library/functions.html#int 

[9] Further info at : https://github.com/nRF24/RF24Network/blob/master/RF24Network.h#L413 

[10] Further info at: https://github.com/nRF24/RF24Network/blob/master/RF24Network.h#L467 

[1] Learn about ‘decode()’ : https://docs.python.org/3/library/stdtypes.html#bytes.decode 

[12] Learn more about ‘split()’: https://docs.python.org/3/library/stdtypes.html#str.split 

[13] Learn about ‘float()’: https://docs.python.org/3/library/functions.html#float 

[14] Latest version of rf24_receiver.py: https://github.com/futureshocked/RaspberryPiFullStack_Raspbian/blob/master/rf24_receiver.py 
[15] The project's “home”: https://tmrh20.github.io/RF24/ 
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Notice the output contains statistics from the RF24 module as 


non-zero values) as well as the rest of the NRF configuration. If 


via SPI, you would either get an error message from the exam 


it is 
starting up. It contains valid values for the RX, an address (that 


is, 
the 


RF24 and RF24Network modules were not installed properly, or if 
the Raspberry Pi could not communicate with the nRF24 module 


ple 








program (it would not start at all), or the configuration values wo 


uld 


be blank. Now the RF24 modules are installed, the Python script 


you installed will be able to work. M 
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Practical 
ESP32 Multitasking (6) 


Event Groups 


By Warren Gay (Canada) 


Synchronisation between multiple tasks often arises as a requirement when developing 
applications using FreeRTOS. In the previous instalments of this series, we examined 
semaphore and task notifications. However, these are only capable of sending an event 
from a task or interrupt service routine (ISR) to a single receiving task. When you need to 
broadcast an event to several tasks, the Event Group capability is the solution you will be 
looking for. In this final article of the series, we examine the capabilities this feature offers 
embedded developers. 


Let's start by examining a potential use case. A MIDI drum machine 
may be required to make four simultaneous sounds based upon an 
input command received by its serial channel. Ideally, all sound-gen- 
erating tasks should start at the exact same time to avoid sounding 
‘off’ to the human ear. Coordination could be achieved by the use of 
four separate semaphores and relying upon the speed of the CPU for 
timely delivery. But that approach is clumsy and doesn't scale well as 
the number of receiving tasks increase. Event Groups are the preferred Figure 1: Event flags within the C data type EventBits_t. 
implementation method in FreeRTOS for coordinating multiple tasks 

from a single event source. 





Reserved Event Flag Bits 


Event flags 

FreeRTOS defines 24 event flags for each Event Group object created 
(Figure 1). These flags are represented in the C data type EventBits_t, 
a 32-bit-wide data type of which 24 bits are available. Bit O is the least 
significant bit (LSB) of the available flags. The most significant 8 bits 
are reserved for internal use by FreeRTOS. 


How these 24 bits are assigned and used by the application is left up 
to the programmer. In this demo, the loop () task generates an event 
every second that results in two tasks synchronously starting differ- 
ing blink patterns via their associated LEDs. Bit 0 of the Event Group 
(value 0b0001/decimal value 1) notifies a task named blink2() that 
blinks LED1 twice. Bit 1 of the Event Group (value 0b0010/decimal 
value 2) is assigned to notify a task named blink3() that blinks 
LED2 three times. 





Demo program 

Before we dive into the code, let's review what the demo program 
hopes to accomplish. Two LEDs are driven by GPIO pins 25 and 26 
(lines 5 and 6) in the active high configuration (see the schematic in 
Figure 2). These GPIOs are configured in the setup() function as 
outputs (lines 62 to 65). Task blink2() controls LED1 by blinking it 
twice before waiting for the next event (lines 19 to 25). Task blink3() Figure 2: The schematic for the demo program evigrp.ino. 
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Listing 1: The Arduino program evtgrp. ino using event groups. [1] 


0001: // evtgrp.ino 

0002: // MIT License (see file LICENSE) 
0003: 

0004: // LED is active high 

0005: #define GPIO_LED1 25 

0006: #define GPIO_LED2 26 

0007: 

0008: #define EVBLK2 0b0001 

0009: #define EVBLK3 0b0010 

0010: #define EVALL 0b0011 

OOil 

0012: static EventGroupHandle_t hevt; 
0013: 

0014: void blink2(void xarg) { 

0015: 

0016: Ole (S59) ab 

0017: // Call blocks until EVBLK2 bit set, 
0018: // and same bit is cleared upon return 
0019: xEventGroupWaitBits ( 

0020: hevt, 

0021: EVBLK2, 

0022: pdTRUE, 

0023: pdFALSE, 

0024: portMAX_DELAY 

0025; Js 

0026: // Blink 2 times 

0027: for aime 608 30 << 2S sre) al 
0028: digitalWrite(GPIO_LED1,HIGH) ; 
OO29is delay(120) ; 

0030: digitalWrite(GPIO_LED1, LOW) ; 
0031: delay (120) ; 

0032: } 

0033: } 

0034: } 

0035: 

0036: void blink3(void xarg) { 

0037: 

0038: role (ES) ab 

0039: // Call blocks until EVBLK3 bit set, 
0040: // and same bit is cleared upon return 
0041: xEventGroupWaitBits ( 

0042: hevt, 

0043: EVBLkK3, 

0044: pdTRUE, 

0045: pdFALSE, 

0046: portMAX_DELAY 

0047: Jia 

0048: // Blink 3 times 

0049: ror (C me SEOs sos SG same N af 
0050: digitalWrite(GPIO_LED2,HIGH) ; 
0051: delay(75); 

0052: digitalWrite(GPIO_LED2, LOW) ; 


controls LED2 by blinking it three times before waiting for the next event 
(lines 41 to 47), Both tasks are identical, except for the number of times 
the blink loop is executed (lines 27 and 49) and the delay times used. 


Synchronisation 

Synchronisation is achieved by having the task functions block in a 
call to xEventGroupWaitBits(). Until the event is triggered, execu- 
tion stalls inside this function call. Once the Event Group is notified, 





0053: delay(75); 

0054: } 

0055: } 

0056: } 

0057: 

0058: void setup() { 

0059: int app_cpu = xPortGetCoreID(); 
0060: Baselypele Ge; 

0061: 

0062: pinMode(GPIO_LED1,OUTPUT); 
0063: pinMode(GPIO_LED2, OUTPUT) ; 
0064: digitalWrite(GPIO_LED1, LOW) ; 
0065: digitalWrite(GPIO_LED2, LOW) ; 
0066: 

0067: delay(2000) ; 

0068: 

0069: hevt = xEventGroupCreate() ; 
0070: assert(hevt) ; 

oori 

0072: rc = xTaskCreatePinnedToCore( 
0073: blink2, Lp fune 

0074: "blink2", // name 

0075: 1024, // stack bytes 
0076: hullptre, // are ptr 

0077: ale // priority 

0078: nullptr, // ptr to task handle 
0079: app_cpu // cpu# 

0080: es 

0081: assert(rc == pdPASS) ; 

0082: 


0083: rc = xTaskCreatePinnedToCore( 


0084: blink3, f/f une 
0085: "blink3", // name 
0086: 1024, // stack bytes 
0087: nullptr, // arg ptr 
0088: il Lf priority 
0089: nullptr, // ptr to task handle 
0090: app_cpu // cpu# 
0091: ye 

0092: assert(rc == pdPASS) ; 
0093: } 

0094: 

0095: void Loop) { 

0096: 

0097: delay(1000) ; 

0098: xEventGroupSetBits ( 
0099: hevt, 

0100: EVBLK2|EVBLK3 

0101: Das 

0102: } 

ONS): 

0104: // End evtgrp.ino 


execution of the stalled tasks resume by returning from the called 
function. The event is triggered every second by a corresponding call 
to xEventGroupSetBits() inthe loop() task (see lines 98 to 101 in 
Listing 1 [1]). 


Creating Event Groups 


The event group is created by calling xEventGroupCreate() (line 69). 
There are no arguments to supply and the function returns a handle to 
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the allocated event group object. The returned data type of the handle 
is EventGroupHand1e_t. If the returned value is zero, your heap has 
run out of storage (hence the assertion check in line 70). 


0069: hevt = xEventGroupCreate() ; 
0070: assert (hevt) ; 
Notification 


There are different choices for manipulating event groups. In 
this article, we're using one of the simpler functions named 
xEventGroupSetBits(). 


EventBits_t xEventGroupSetBits( 
EventGroupHandle_t xEventGroup, 
const EventBits_t uxBitsToSet 


// Handle 
// Bits to set 


); 


The handle xEventGroup specifies the event group to be operated 
upon, while the argument uxBitsToSet specifies the event bits 
you want to atomically set. The value returned will be the event bits 
that were in effect after the call to xEventGroupSetBits() returns. 
However, you need to be aware that the returned value may not always 
include the bits that you have just set as the receiving tasks may have 
already cleared them upon receipt. 


The loop() task calls the xEventGroupSetBits() function setting 
bit O and bit 1 using the macro expression EVBLK2 | EVBLK3. 


0008: #define EVBLK2 0b0001 
0009: #define EVBLK3 0b0010 
0098: xEventGroupSetBits( 

0099: hevt, 

0100: EVBLK2 | EVBLK3 

0101: J3 


From this call, it can be seen that both bits 0 and 1 are set atomically 
by this call. 


loop() task 

The loop() task delays for one second (line 97) and then sends out 
an event notification (lines 98 to 101). Then, following Arduino tradition, 
the loop() function exits and repeats. This results in events being 
triggered approximately one second apart. 


Receiving tasks 

The tasks blink2() and blink3() are notified by the event group 
using the saved handle (lines 12 and 69). For example, blink2() has 
its execution suspended at lines 19 to 25 until an event is sent. Likewise, 
blink3() has its execution suspended at lines 41 to 47 until an event 
is sent. Because the events are triggered atomically by lines 98 to 101, 


=- WEB LINKS 


[1] Code for evtgrp.ino: https://bit.ly/35YrjCN 


both tasks will resume at the same time. If the two tasks are assigned 
to the same CPU they will then be scheduled to execute one after the 
other. If the two tasks are assigned to different CPUs then it is indeed 
possible for them to both resume and execute simultaneously. 


Once execution resumes in each task they can then blink their LED 
in their own unique way. Once that blinking has been completed, 
execution resumes at the top of the task loop by waiting for the arrival 
of the next event. 


Event clearing 
The xEventGroupWaitBits() function call is a little bit tricky and the 
flexibility that it affords does add a little complexity. So, let's break it down: 


EventBits_t xEventGroupWaitBits ( 
const EventGroupHandle_t xEventGroup, // Event group handle 
const EventBits_t uxBitsToWaitFor, 
const BaseType_t xClearOnExit, 
const BaseType_t xWaitForAllBits, 
TickType_t xTicksToWait 


); 


The first argument is the handle to the event group referenced. This 
is quite straightforward. Argument two specifies the event bits that 
the function wants to wait for. In the demo program, we specified the 
macro EVBLK2 (line 21) for the blink2() task and macro EVBLK3 for the 
blink3() task. The reason for using separate bits will be evident shortly. 


The third argument xClearOnExit is a C language version of a boolean 
value (pdTRUE was supplied in lines 22 and 44). This informs the function 
to clear the received event bits before returning. So the blink2() task 
waits for bit 0 to become set (macro EVBLK2), and the argument three 
value pdTRUE informs it to clear that bit upon receipt and return. This 
wait-and-clear operation is performed atomically. 


In our particular case, argument four is academic but let's examine it. 
Argument xwWaitForAllBits is likewise boolean and specifies when 
the function should return: 


> when any of the bits being waited for are set (pdFALSE), or 
> only once all of the bits being waited for are set (pdTRUE). 


Our example only expects a single bit (bit O for blink2() and bit 1 
for blink3()), so indicating any or all doesn't have a material effect. 
However, if you wish to wait for a combination of bits this capability 
can be quite useful. 


Event control 

The reason why separate event bits were needed may now be evident. 
Each receiving task waits for and then clears its own event bit with a 
call to xEventGroupWaitBits(). Thus there needs to be a separate 





[2] W. Gay, “FreeRTOS for ESP32-Arduino’, Elektor 2020: https://bit.ly/2U2Yhg1 


[3] FreeRTOS documentation: https://bit.ly/386HZL6 
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bit for each task. In the Loop() function both tasks are notified simul- 
taneously by setting their specific event bits at the same time (line 100). 


As can be seen, the event group bits can be used to create very 
complex and creative application code. For more details on the 
additional functions see the book FreeRTOS for ESP32-Arduino [2] 
and the FreeRTOS documentation [3]. 


Running the demo 

The demo doesn't use the Serial Monitor and can be run on just 
about any ESP32 that makes GPIO 25 and 26 available (or you can 
change lines 5 and 6 of Listing 1 to use different outputs). Flash the 
program evtgrp.ino into the ESP32 with two LEDs and 220-ohm 
resistors attached according to the schematic in Figure 2. Once 
the ESP32 starts execution there should be blinking LEDs — once 
per second LED1 should blink twice and then wait while LED2 
should blink three times (quickly) and then wait. The process will 
repeat every second. 


Synchronisation complete 

This demo illustrates how two completely independent tasks, blink2 () 
and blink3(), can be synchronised using a single Event Group object. 
The loop() task broadcasts its event from lines 98 to 101. This approach 
can be extended to up to 24 tasks if necessary (the limit is defined by 
the number of event flags available in a single Event Group). While 
this article has shown one way to use Event Groups there are a whole 


host of other, more sophisticated ways to coordinate events using 
other FreeRTOS functions. 
200528-01 


Questions or Comments? 

Do you have questions or comments about this article? 

Email the author at ve3wwg@gmail.com or contact Elektor at 
editor@elektor.com. 
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HOMELAB PROJECT 





Multi-Channel 
Power Analyzer 


Up to 3 Channels, with Graphic and Alphanumeric Display 


By Wil Dijkman (The Netherlands) 


When making voltage, current and power measurements on AC-powered devices things are 
getting more complicated than measuring DC, because waveform and phase-shift between 
voltage and current play an important role here. This instrument not only measures and 
calculates quantities, but also shows waveforms and spectra of AC-signals on a graphical LCD. 


This project was inspired by the AC/DC Power Meter published 
in Elektor Magazine in September 2015 [1]. At first | thought it was 
very interesting and | wanted to build one myself, but | found some 
limitations and drawbacks in this design, so | decided to develop an 
“improved” design. Things | wanted to improve were: 


> The input circuit: It should be possible to measure current and 
voltage independently: the current through the connecting leads 
should not influence the voltage reading. 

> The sampling rate: the low sampling rate makes it only possi- 
ble to measure the first eight harmonics of a 50 Hz signal (with 
perfect filter). This should be increased to the first 40 harmonics. 

> The range switching and offset correction must be made 
automatically. 


Satellite boards 


—-<-< 





mainboard Bea touchscreen 


= 





= a 





Figure 1: Block diagram of the Power Analyzer. 


66 January & February 2021 www.elektormagazine.com 


This means that the input and amplifier circuit need a complete 
redesign. Also, a microcontroller is needed at the hot-side, to make 
automatic offset correction and auto-ranging possible. The block 
diagram in Figure 1 shows a main board and (up to) three satellite 
boards. 


The Main board 

The schematic (see Figure 2) is largely a copy of the EasyPIC V7 board, 
with a graphic LCD touch screen as user interface. A square wave 
oscillator (circuit around IC1) generates a 12 Vpp square wave with 
a frequency of about 150 kHz for powering the satellite boards. The 
data communication with the satellite boards will be via 12C, where 
the microcontroller on the main board is the master and the satellite 
boards are the slaves. 


The power supply section of the main board supports either a 12 V 
stabilized or a 15.18 V supply without stabilization. The selection can 
be made by a solder joint (SJ1). There are two other solder bridges/ 
jumpers: MAX1 and MAX2. With these, the number of channels can 
be set for the master: closing MAX1 only means one, closing MAX2 
means two and closing both means three channels (satellite boards). 
Some jumper wires (marked with Jx in schematics and on the main 
PCB layout) are used to avoid the need for a multilayer PCB. 


The Satellite board 

On the Satellite boards (schematic in Figure 3) | wanted to measure 
voltage and current independently. This is not fully realizable, but with 
the circuit the low voltage input and the current input can float about 
+/- 1 V with respect to each other. This is realized by the diode D3, 
D4, D7, D8. Without measures taken, the circuit can be damaged by a 
wrong connection: the high potential to the low voltage input and also 
the current input at the low voltage side. To prevent this damage, the 
circuit with T10...T14 and reed relay K1 is added. A first current limita- 
tion is realized by R11: at 750 V input voltage the maximum current is 
0.5 A. If the current through R11 is larger than some 10 to 20 mA, there 








will be a small current through R34, which is detected by T11 and T13. 
This will trigger the thyristor circuit with T10 and T12. Once triggered 
the thyristor circuit will remain in this state and will switch off T14 and 
K1. Signal OC indicates to the microcontroller that the protection is 
triggered. When there is no power K1 is also switched off (V-low is 
disconnected), so then the circuit is safe. To restore operation the power 
of the circuit must be disconnected and connected again. 


The voltage divider gives 100 mV output at the maximum input voltage 
of 750 V (DC), the maximum AC voltage will be about 500 V. The 
voltage drop at the 6.5 mQ current sense resistor R62 is about 100 mV 
at 15 A-DC (about 10 A-AC). The amplifiers for voltage and current are 
identical, so I'll describe only the voltage amplifier. T1, T2 and T4, T6 
serve as switches to connect the differential amplifier either with the 
signal from the input circuit or short the input to make offset measure- 
ment possible. The value of the offset can be stored and subtracted 
later from the measurement to make a “clean measurement” possible. 
The amplifier is a common instrumentation amplifier. T3, T5 switch 
the gain of the first stage to either 1x or 25x. IC5 makes the differential 
signal single ended. The last stage with IC4 can switch the gain to 
either 1x or 5x. So there can be four gains: 1x, 5x, 25x or 125x. The gain 
setting will be under control of the microcontroller 1C13. The ampli- 
fier will generate a positive or negative signal with respect to COMV. 
This signal is 0.5 times VREF, which is generated by the circuit around 
IC3. VREF is 4.5 V, so COMV, COMI and CINV are 2.25 V. VREF and 
CINV are connected to the ADC of the PIC-controller. The ADC of 
the PIC18F26K80 used here can convert to 13 bits when used in the 
indicated way (12 bits plus a sign bit). For 750 V this gives a resolution 
of about 200 mV per bit. For 6 V about 1.6 mV/bit. | consider this as 
sufficient for this purpose. 


The 12C address of a satellite board is programmed by closing or 
opening SJ1 and SJ2 on the board. Closing SJ1 makes the board 
channel 1, closing SJ2 makes it channel 2 and closing both solder 
joints makes it channel 3. 





WARNING. Working with high voltage 
can be fatal. The circuit described here 


is not for beginners. Do not build or use 
it unless you are experienced in dealing 
with high voltages! 





Galvanic isolation 

The square wave coming from the main board is fed to the trans- 
former at the right (ratio 1:1). The rectifiers give then an output voltage 
of something less than 6 V. With parallel regulators this is controlled 
to +/- 5 V. The windings of the transformer have an isolation value of 
900 V, so the total isolation will be 1800 V peak, provided that the rest 
of the construction is OK. The I2C signal will go via C14, which has an 
isolation value of 4 kV peak. So the satellite boards will be completely 
floating with respect to the main board and with respect to each other. 


Update of the satellite board circuit 

After the first prototype was built, tests proved that some correc- 
tions had to be made. The crosstalk from the switching signal to the 
measurement signal in the offset switches had to be limited. Therefore 
C41-R102 and C40-R103 are added. The protection circuit reacted on 
spikes, for example when a test lead was plugged. The sensitivity for 
spikes has been decreased by adding C33. D14 and R101 also limit he 
sensitivity for positive signals. 


When the amplifiers have the highest gain (approximately 2750x), an 
offset control is needed. This control is switched off when the gain is 
lower. Depending the sign of the offset a selection has to be made 
with the solder jumper. 





o 
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Figure 2: Main board schematics. 
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Figure 3; Satellite board schematics. 


Unfortunately | forgot some decoupling capacitors in the supply part, 
these had to be added too. The part list for this project in Open Office 
format can be downloaded from [2]. Order codes for Farnell are given, 
but of course you can choose any supplier. 


Software for the satellite board 

The program is written in mikroBasic for PIC (V5.611) from MikroElektronika, 
a programming language that is relatively easy to understand. 

| wanted that a frequency range from (a bit) less than 50 Hz to a few 
hundreds of Hz could be processed. Therefore, the signal needed to 
be sampled for at least 30 ms. Then, at 50 Hz there are at least three 
zero-crossings, so you can detect one period. But that is only true when 
these zero-crossings are equidistant. With a duty cycle unequal to 50 % 
at 50 Hz, 30 ms is not sufficient, that's why | have chosen for 35 ms. 
Then with a duty-cycle of less than 25 % there it is possible that the 
frequency is not correctly determined at 50 Hz, with higher frequen- 
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cies there is no problem. Signals with less than three zero-crossings 
during the sampling period are treated as DC. 


The second question is how many samples will be taken in these 
35 ms. A sampling frequency of 10 kHz or higher would be ideal. | have 
chosen for 357 samples at 10.2 ks/s. This leads to a integer multiple 
of samples for 50 and 60 Hz signals. These frequencies can then be 
analyzed with the highest accuracy. 


There is a library with 12C commands in mikroBasic, but these are only 
for an I2C master. For an |2C-slave | had to write my own procedures. 
These procedures are needed to setup and control the communi- 
cation with the main board, the 12C master. The latter just requests 
and displays information from the satellite boards, (auto-) ranging 
and offset, all signal processing, including sampling and filtering is 
performed on the satellite board(s). 





Figure 4a: The main board and display attached to the front panel. 


4 


Figure 4b: One satellite board attached to the front. Note the extra isolation 
(thick red tape) between the board and panel. 





Figure 4c: One of the extra support brackets between front panel and cover. 


Fast Fourier transforms are also calculated on the satellite boards. The 
calculations are not invented by me but “borrowed” from [3]. Digital 
filtering is based on chapter 16 of The Scientist and Engineer’s Guide 
to Digital Signal Processing [4]. A Blackman-window is used and the 
filter has 13 coefficients (M=12). The choice of the length of the filter is 
a compromise between calculation time, memory needed and perfor- 
mance (i.e. suppression of signals above 2.55 kHz and attenuation of 
signals below 2.55 kHz). 


A front panel has been designed for a three channel version, which 
can be ordered at Schaeffer's. | used a metal case (order code 1510827 
at Farnell, manufacturer Metcase, M5503110). 


Figure 4 shows some detailed pictures of the hardware in this enclo- 
sure, giving an impression of what the Power Meter can look like and 


Figure 4d: PE-connection 


how the units are fixed in the case. Note the ready-made, standard 
power supply that is used to power the Power Analyzer. 


Figure 4c shows one of two extra brackets, which are added to prevent 
the front panel from bending when test leads are plugged in or out. An 
extra hole in the top and bottom cover must be drilled to attach the 
brackets. | used a metal housing so the enclosure must be connected 
to the mains Protective Earth, see Figure 4d. 


Operation 

After switching on, the measurement screen appears. It displays some 
units and their values for the channel that is selected. At the top of the 
screen you can select other channels (if available). 


The screen can display a maximum of seven measurement values, 
selected in the Configuration Screen. 
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HOW TO CONNECT 


There is a difference between connecting test leads for 
measuring the power consumption of a load or measuring the 
power supplied by a source, as can be seen in Figure 5. With 
the indicated methods the voltage drop of the connection leads 
and the current measurement section is eliminated. The voltage 
difference between the | connections and the V- connection 
must remain below 0.5 V. Otherwise the protection circuit is 
triggered, and the power supply has to be cycled. 


First go to the Main Menu (top right of the screen). Choose Configuration 
and then the Configuration Screen appears with 16 values to choose 
from. The selected values to be displayed are highlighted. 


Some of these values will go without saying, but some need explana- 
tion. Vdis and Idis (distortion) are calculated using: 


where VN stands for the amplitude of harmonic N of the signal. 
Re-P means real power, P-VA means Vrms x Irms, Im-P means imagi- 
nary power, and PF means power factor, i.e. Re-P / P-VA. 

If you choose Eff-> you enter the Efficiency Screen. Here you can 
choose the formula which describes the power relation that you are 
investigating and then you go back to the Configuration Screen. If 


BUILDING THE TRANSFORMER 


Transformer TR1 is home made. Here is the recipe. 


Ingredients (mentioned at the bottom of the parts list): two 
core halves, two clips, one coil former, all for EF20, wire with 
900 V isolation and diameter of max 1.3 mm. 


v 


Take the coil former and cut off pins 2, 3, 4, 7, 8 and 9. 

With the wire make 9 turns between pin 1 and 10. You shall 
exactly fill one layer. 

Repeat to make 9 turns between pins 5 and 6. Again you 
shall exactly fill one layer. 

Put in the core halves and put on the clips. There is no air 
gap. 

If everything went well, you will have a transformer with an 
equal primary and secondary inductance of about 125 pH. 
Capacitance between primary and secondary will be in the 
range of 30 pF. 


v 


v 


v 


v 
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Measuring power consumed by a load 


O Source 


Measuring power, supplied by a source 












Source 





























Power Analyzer 


Power Analyzer 


Figure 5. Connecting the test leads 


you go back to the Measurement Screen, the chosen formula with 
the calculated value is displayed for all channels. 


Back in the Configuration Screen you can also choose for Graphs-> 
Pressing this you can choose between Scope or FFT. Press Scope. This 
brings you to select traces. Trace1 will always be displayed. A selected 
trace will be high-lighted. All traces can be “connected” to a channel 
and to V, | or P of that channel. The display will be “triggered” by a 
positive zero crossing of Trace’. The display will give you an impres- 
sion of the wave shape of the signals and their phase relation. Two 
periods of the signal will be displayed. The amplitude of the signals 
is always the same: voltage signals have the maximum amplitude. To 
distinguish them from voltage signals, current signals are displayed 
with a 80 % and power signals at 60 % amplitude. See for example 
the waveforms of a transformer which goes in saturation in Figure 6. 
The scope display doesn't show absolute values, it's just an indication 
of shape and phase relation. 


Back in the Graphic Screen, press FFT. This shows the FFT compo- 
nents of a selected signal. On top of the screen you can select the 
channel, LINear or LOGarithmic display and either V or |. The largest 
harmonic (usually but not necessarily the first harmonic) is displayed 
at 100 % or 0 dB. The horizontal scale gives the number of the harmon- 
ics, not its frequency. 


When entering the Logging feature, you must first select the time 
period that you want to apply. Possible values are between 0.25 h 
and 128 h in steps of a factor of 2. Next step is to select how many 
traces you want to log (maximum three). Each trace can be linked 
to a channel and from that channel you can choose either V, | or P. 
Pressing Continue immediately starts the logging. An alphanumeric 
screen will be shown, where you can watch the average, maximum 
and minimum value and the elapsed time. You can also go to the 
graphical screen. At the top of the screen you can select another 
trace, if it is switched on. Pressing Return brings you back in the 
main screen, the collected data are lost. 


You can select Crest factor (V-CF or I-CF) in the configuration screen. 
It simply divides the highest peak value (positive or negative) by the 
RMS-value of the signal. Remember that the bandwidth of the measur- 
ing amplifiers is 2.5 kHz, so this function is not suitable for audio. Only 
until, say 250 Hz depending on your taste. 
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Figure 6a: Measurement of a transformer in 
saturation, FFT of current. 


How to calibrate and adjust 
From the Main Screen you can go to the Calibration screen. You can 
choose between calibrating the touchscreen and calibrating the 
channels. At the first start up the touchscreen calibration procedure 
will automatically be presented. Use a pencil or wooden stylus to 
calibrate (and use) the touch screen. 


In the channel calibration you will first be prompted to select a channel. 
Then the software enters a screen where voltage, current and frequency 
can be measured and adjusted. In this screen the automatic ranging 
for V and | is disabled, which will make it easy to adjust the calibration 
for each range. With the arrows (< and >) you can change ranges and 
adjust the measured value. 


The best method to adjust the frequency is to connect a digital oscil- 
loscope to TP8 (signal) and TP2 (GND) on the satellite board of the 
selected channel. Adjust the visible pulse width to 35.00 ms with 
the arrows on the frequency line. Second best method to adjust the 
frequency is to use a signal source with a calibrated frequency of 50 
or 60 Hz and adjust the reading to 50.00 or 60.00 Hz. The reading 
can vary £0.5 %, 


Questions or comments? 

Do you have questions or comments about his article? Email 
the author at w.j.dijkman@onsbrabantnet.nl or contact Elektor 
at editor@elektor.com 


= WEB LINKS 


[1] 
[2] 
[3] 
[4] 


FFT calculation: www.nicholson.com/dsp.fft1.html 


Figure 6b: Measurement of a transformer in 
saturation, voltage and current. 
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Figure 6c: Measurement of a transformer in 
saturation, voltage and power. 


When done calibrating a channel, press ->OK. Then the calibration 
data are stored on the satellite board of the selected channel. 


As far as l'm concerned this project is finished. There will be no more 
large additions or changes. But of course, | will answer any question. 


This article is based on the information presented on the Elektor Labs 
project page at [2]. On this page, more detailed information on this 
Power Analyzer including software, PCB design files and BOM can be 
found or downloaded. The Eagle CAD-files on Elektor Labs are up to 
date with the most recent changes, but newer versions of the PCBs 
have not been built and/or tested! 14 
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o 


Analogue 
Filter Design (Part 3 


Passive Filters 


By Alfred Rosenkränzer (Germany) 


The third and final part of this series on the design of analogue filters deals with the 
subtleties of passive filters. Since only purely passive components such as resistors, coils 
and capacitors are used here, amplification is not feasible. Thus high input and low output 
impedances cannot be realised. However, high frequencies in the three-digit MHz range and 
above are less problematic. 


The input impedance of active filters can be made very high by about the correct ‘termination’ or the matching of impedances at 
adding a buffer at the input; a buffer at the output can make the the input and the output. However, passive filters are often still used 
output impedance very low. As a result, we no longer need to worry at very high frequencies. These are designed for specific input and 
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Figure 1: Basic schematics for passive low-pass and high-pass filters with PI and T structures from first through to sixth order. Both the corner frequency and 
the frequency characteristic depends on the component values. The structures shown here are suitable for Bessel, Butterworth and Chebyshev filters. 
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Figure 2: Basic schematics for low-pass and high-pass filters of third through to sixth order with Cauer or inverse Chebyshev characteristics in PI and T 


configurations, 


output impedances (which do not have to be identical). It should 
be noted that deviations from the expected source or load imped- 
ance can have a strong influence on the filter characteristic. In 
this article we will take a look at the types of passive filters that 
are commonly used and what needs to be considered. 


Structures 
In Figure 1 you can see the basic structure of high- and low-pass 
filters of the first through the sixth order. By choosing the correct 
values for the components, these structures allow filters with Bessel, 
Butterworth and Chebyshev characteristics to be realised. You can 
choose whether a filter starts with a component in series with the 
others (T-structure) or with a component to ground (Pl-structure). 





In the leftmost column of Figure 1 are the PI low-pass filters that 
all begin with a capacitor to ground at their inputs. In the second 
column are the T low-pass filters that start with an inductor in series. 


The high-pass filters are exactly the other way around. In the third 
column we see the PI high-pass filters with an inductor to ground 
and, in the rightmost column, the T high-pass filters with a capac- 
itor in series. 


At the higher orders components are added alternating between 
ongitudinal (in series) and transversal (to ground). These additional 
components have different values than the first components. For 
the desired functionality it does not matter whether we choose 
aT or PI structure. But, because inductors are not popular with 
electronics designers, it is common to attempt to use as few of 
these as possible. 














Figure 2 shows the basic structure of Cauer (elliptical) and inverse 
Chebyshev filters (also known as type 2). Here the inductors or 
capacitors are replaced with parallel or series resonant circuits. 
Drawn are low- and high-pass filters in PI and T configurations 
from the third through to sixth order. 





Figure 3 shows the basic structure of band-pass and band-stop 
filters with a Bessel, Butterworth or Chebyshev characteristic (from 
third through to seventh order), and in Figure 4 we see the more 
complex structures with Cauer and inverse Chebyshev characteris- 
tics (fifth and seventh order). Here too there are Pl and T variants. 





Dimensioning 
A Bessel or Butterworth filter is entirely determined by the filter 
characteristic, the -3dB corner frequency, the chosen structure, the 
order, and the input and output impedances. In contrast to the active 
filters, with passive filters there is no freedom at all when it comes to 
choosing component values. If you would like to select, for example, 
a standard value from an E-series for an inductor, then you will have 
to adjust the corner frequency of the filter at a given impedance a 
little. Of course this is only possible if the application allows it. 











How the characteristics of a Butterworth filter change for the differ- 
ent orders has already been discussed in part 1 of this series [1]. Now 
we can see how the component values change depending on the 
chosen corner frequency. In Figure 5 we see the fully dimensioned 
schematic of a fifth-order Butterworth low-pass filter with a corner 
frequency of 1 MHz. If we want to double the corner frequency 
to 2 MHz we only need to halve the values of the inductors and 
the capacitors. This is no surprise because the corner frequency 
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Figure 3: Basic schematics for band-pass filters and band-stop filters of third, fifth and seventh order with Bessel, Butterworth or Chebyshev characteristics 
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Figure 4: Basic schematics for band-pass and band-stop filters of fifth and seventh order with Cauer or inverse Chebyshev characteristics in PI and T 


configurations. 


the stop band. How much ripple we can allow depends on the 
application. 


In Figure 8 we have enlarged the pass-band from Figure 7. Here 
we can see that the corner frequency is not the -3dB point, as with 
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Figure 5: Butterworth fifth-order low-pass filter with PI structure and with a 
corner frequency of 1 MHz. 


Figure 6: Frequency response of a fifth-order Butterworth 
low-pass filter in the pass-band. The green curve is the correct 
response and the red line shows what happens when a 100-Q 
filter is connected to a source and load of 50 Q. 


other filters, but the point where the curve drops below the defined 
amount of ripple. If you would like to normalise the curves to the 
-3dB point, in order to compare them better, you will have to adjust 
the corner frequency accordingly. 
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Figure 7: Frequency response of seventh-order, 1 MHz Chebyshev low-pass 
filters with a ripple in the pass-band of 0.1 dB (brown), 0.5 dB (blue), 1 dB 
(green) and 3 dB (red). 
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Figure 9: Seventh-order Cauer low-pass filter with a ripple of 0.5 dB in the 
pass-band and a minimum attenuation of 40 dB. The component values for 
other levels of attenuation are shown in Table 1. 
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Figure 10: Frequency responses of seventh-order, 1-MHz Cauer low-pass 
filters with a minimum attenuation of 40, 50, 60 and 70 dB. 
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Figure 8: A close-up of the pass-band from Figure 7. The corner frequency 
corresponds to the point on the curve where the amplitude drops below the 
defined ripple. Ripple: 0.1 dB (brown), 0.5 dB (blue), 1 dB (green) and 3 dB 
(red). 


With the Cauer filter the minimum attenuation in the stop band 
is another additional parameter. The notches provide a much 
steeper transition in the stop band, but the curve then returns 
to a lower attenuation. The number of notches corresponds to 
the number of resonant circuits in the circuit (as these have 
different frequencies). Figure 9 shows a seventh-order Cauer 
low-pass filter with a minimum attenuation of 40 dB. Table 1 
lists the component values for a minimum attenuation of 40, 
50, 60 and 70 GB. 


Figure 10 shows the frequency responses of all four of the Cauer 
low-pass filters. The height of the ‘bumps’ corresponds to the 
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Figure 11: Close-up of the pass-band from Figure 10 with a minimum 
attenuation of 40 dB (brown), 50 dB (blue), 60 dB (green) and 70 dB (red). 





Table 1: Component values for Figure 9. 









































Attenuation C1 C2 c3 C4 C5 C6 C7 L1 L2 L3 
40 dB 1n10 6n56 4n27 4n62 4n71 3n58 3n01 790 338 4u37 
50 dB 766p 4n10 2n77 4n90 5n48 4n52 3n61 8u50 4u78 5pu61 
60 dB 541p 2n74 1n88 5n07 6n14 5n36 4n09 8y92 6y04 6y65 
70 dB 385p 1n90 1n31 5n20 6n68 6n07 4n45 9u22 7u11 749 








minimum attenuation. You can see the different slopes of the 
curves in the transition region and the accompanying minimum 
attenuation. But this also changes the frequency of the notches. 
f you would like to filter out a fixed interference frequency froma 
signal, you could tune such a notch to that frequency by adjusting 
the corner frequency or the minimum attenuation. With this you 
have to keep a close eye on the tolerances of the components and 
therefore the exact position of the notches. The enlargement of 
the frequency response in Figure 11 shows that the ripple in the 
pass band is 0.5 dB for all filters. 

















The final filter characteristic is the inverse Chebyshev (IT). This looks 
like a Butterworth filter in the pass band and therefore has no ripple, 
so this parameter is omitted. But in the pass band the IT characteristic 
looks more like that ofa Cauer filter with notches and an accompany- 
ing minimum attenuation. The basic schematic is the same as that 
for the Cauer filter (Figure 9) and only the dimensioning is different. 
Figure 12 shows the frequency response of the inverse Chebyshev 
filters with a minimum attenuation of 50, 60 and 70 GB. Figure 13 is 
azoomed-in view of the pass-band of the characteristic of Figure 12. 





All-pass filters 
In analogue television technology there was (once) the need for 
steep filters, but the large overshoot of the step-response brought 
about strong interference signals. That is why the group delay was 
‘pepped up’ using all-pass filters. This took quite a bit of effort and 
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Figure 12: Frequency responses of the inverse Chebyshev filters with a 
minimum attenuation of 50, 60 and 70 dB. The colours are self-explanatory. 


the filters had to be tuned by hand using a network analyser. There 
aren't many filter programs that can compute the complete filter. 
The increasing amount of digitisation (also in video technology), 
along with higher clock speeds and oversampling in DACs and 
ADCs, means that there are not the same high demands on analogue 
filters as there used to be. This means we can now do without the 
compensation for group delay. Figure 14 shows the circuit of a 
passive, second-order all-pass filter and, in Figure 15, we see the 
corresponding characteristic of the group delay. 





Nowan excursion into practice: in Figure 16 you can see a DIY video 
filter using Neosid inductors (the copper-coloured, square components 
with a tuning core). The two coils on the left are part of a fifth-order 
Cauer low-pass filter. The block of six coils are part of an all-pass filter. 
Each time there are multiple capacitors connected in parallel in order 
to realise the necessary ‘awkward’ values. The round, blue components 
are KP capacitors in the nF range with a tolerance of 2%. 





Unusual filters 

The filters that we have discussed so far are ‘single ended’: they 
operate with single-ended signals with respect to ground. But it is 
also possible to build passive filters for differential signals. 


Differential filters 
Modern ADCs and DACs for high signal frequencies have differen- 
tial inputs and outputs. It is therefore obvious that the necessary 
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Figure 13: Close-up of the pass-band of Figure 12 with a minimum 
attenuation of 50 dB (blue), 60 dB (green) and 70 dB (red). 
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Figure 14: Schematic of a passive all-pass filter of the second order. 
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Figure 15: Characteristic of the group delay of the second-order, passive 
all-pass filter in Figure 14. 











Figure 17: Combination of two ‘normal’ Butterworth low-pass filters to filter a 


differential signal. 
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low-pass filter that is connected directly to the DAC output and 
even the anti-aliasing filter at the ADC input are also differential. 
The circuit in Figure 17 consists simply of two identical 10 MHz 
Butterworth low-pass filters of the fifth order in a conventional 
single-ended design. The signal paths have no shared compo- 
nents (except ground) so component tolerances can cause differ- 
ent behaviours in the two ‘channels’. 


The second variant, in Figure 18, looks more like a real differential 
filter, but here each of the two capacitors from Figure 17 that were 
connected to ground are now combined into one. They therefore 
now affect both signal paths in equal amounts. In this case differ- 
ences can only occur because of the inductors. 





For differential or push-pull signals, both these circuits exhibit 
the same filter operation. But for common-mode signals the filter 
behaviour is different. Figure 19 shows that, in the combined filter 
of Figure 18, only the inductors influence the frequency response 
and that, therefore, there is only a weak filter effect for common- 
mode signals. Although the common-mode signals from DACs are 
reduced by the differential amplifier that follows, this is not optimal 
because the common-mode rejection of RF amplifiers reduces as 
the frequency increases. Every solution always has its advantages 
and disadvantages. To realise filter stages that are as identical as 
possible we can, for example, use filter modules from the same 
production batch so that the filters are as identical as possible. 




















Double-inverse fourth-order Chebyshev filter 
I noticed this filter when reverse-engineering a filter that I had 
bought. It consists of two fourth-order filters joined together 
(Figure 20) and has a nice characteristic that can be easily realised 
with components from the standard E-series. It also requires few 
‘awkward’ values, making building it much simpler. If you would 
like to change the corner frequency of the filter, then you can 
change the values within the standard E-series. This advantage 
is however at the cost of a small dip in the pass-band. Figure 21 
shows the frequency response of this filter, which has an impres- 
sive minimum attenuation of 70 dB in the stop-band. Both notches 
have the same frequency and reinforce each other. In Figure 22 
we have enlarged the response in the pass-band where we can see 
the characteristic dip at 75 MHz. 
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Figure 18: This variant combines the capacitors Cx and Cx’ into one 
capacitor with half the value of capacitance that, in Figure 17, were each 
connected to ground individually. 





Choice of components 
As we already noted at the beginning, there are no degrees of 
freedom when dimensioning the components for passive filters. 
When computing these reasonably advanced filters the use of 
specialised software is essential. At [2], [3] and [4] you will finda 
selection of suitable filter programs. The values for the inductors 
and capacitors that are calculated this way will not be available in 
most cases. With capacitors this problem is quite easily solved: 
imply connect two or three capacitors in parallel to get as close 
to the desired awkward value as possible. Capacitors are, after all, 
small and not that expensive. You do, however, have to take toler- 
ances into account. 





nN 








Ina simulation [5] you will have to verify whether the frequency 
response of the filter is close enough to the ideal when using the 
actual component values. When building a prototype you cannot 
fail to measure and verify the value of the capacitors before fitting 
them. Passive filters do not really behave any differently to active 
filters and the same is true for both types: a filter is only as good 
as its capacitors. SMD capacitors of the X7R type have therefore 
no place in filter applications. Good capacitors are (unfortunately) 
usually large and not very cheap. You can only make a start on the 
layout of the circuit board once the circuit is finished and you know 
exactly which components you will be using. 





Unfortunately the situation with inductors is much more diffi- 
cult. You shouldn't even try connecting them in parallel. Even a 
series connection will only work if the inductors are not magnet- 
ically coupled. To prevent magnetic coupling you have to fit them 
perpendicular to each other and arrange them in a zigzag pattern 
on the circuit board. You can admire this in the filter of Figure 23, 
although the third inductor at a relative angle of 45° is not really in 
a optimal position. In the filter of Figure 24 the small blue induc- 
tors are not connected in series and there are also no capacitors 
connected in parallel. The manufacturer probably has these compo- 
nents specially manufactured so that they fitted perfectly. 

















ae 











A possible way out of the problems with inductors is the use of 
adjustable versions. Here you can change the self-inductance within 
certain limits by turning the ferrite cap or core. This is, for example, 
the case with the Neosid inductors that are used in Figure 16. 





There is something else that needs to be taken into account with 
inductors: the windings have an ohmic resistance that often cannot 
be ignored. We have to measure this or find it in the datasheet and 
carry that over into the simulation when dimensioning the filters. 
The non-ideal behaviour of the inductors, as a consequence of the 
resistance of the windings, can lead to a reduced frequency response 
in the pass-band. This has to be either corrected or compensated 
for in the circuit that follows. 








n general, larger inductance values use coils with ferrite cores that 
act as a kind of ‘amplification’ compared to the self-inductance 
of the winding on its own. Depending on the size of the core, the 
number of turns, and the size of the current that flows, the core 
can become magnetically saturated and therefore generate an 
enormous amounts of distortion. If more harmonics are measured 
at the output ofa filter than at the input, the signal level should 
be reduced or inductors with larger ferrite cores should be used. 
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Figure 19: Common-mode frequency response of the double SE-filter of 
Figure 17 (red) together with the combined filter of Figure 18 (green). 
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Figure 20: Double inverse Chebyshev filter of the fourth order. 
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Figure 21: Frequency response of a fourth-order double inverse Chebyshev 
filter. 
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Figure 22: Close-up of the pass-band of the filter in Figure 20 showing the 
typical small dip near 75 MHz. 





Figure 24: A filter in SMD technology with inductors at an angle of 90°. 
Noticeable: the blue inductors are not connected in series and the 
capacitors are not connected in parallel. 


Layout 

In addition to the already mentioned zigzag pattern for the arrange- 
ment of inductors, you have to ensure short, direct connections 
to ground. Double-sided printed circuit boards with one side for 
signals and one side for ground make this much easier. Especially 
at higher frequencies, and therefore lower capacitance, you must 
not forget that the solder pads themselves act as little capacitors 
with respect to ground. If this is relevant you will need to take 
these ‘parasitic’ capacitors into account when selecting the value 


of the capacitor. 
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Figure 23: The innards of a filter. Note the positioning of the inductors. 


Questions or Comments? 
Do you have any questions or comments related to this article? 
Then email Elektor at editor@elektor.com. 
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“Analogue Electronics Design - Part 1: Analogue filter theory’, Alfred Rosenkranzer, Elektor September/October 2020: 
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LC Filter Design Tool: https://rf-tools.com/Ic-filter/ 
AADE: https://getwinpcsoft.com/Filter-Design-179557/download/ 


Quickfil 5.1 (DOS program): www.omicron-lab.com/products/vector-network-analysis/quickfil/ 


Simetrix: www.simetrix.co.uk 
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Wireless Measurement Module 























By Harry Baggen (Elektor) 


There is often a desire to extend an existing 
circuit or some equipment so that it can 
display voltage, current and measurement 
of other parameters. Today, such 

capability is integrated into measurement 
modules of such low price there is 
little point in building them yourself. 
One example is the JOY-iT VAX-1030. 
For around £40/£35/$45 it offers such 
capabilty as well as communication 
over a wireless link. 


What can you expect at such a low price? I honestly 
didn’t imagine very much when I saw the small box, 

but I was pleasantly surprised when I inspected its 
contents. They consisted of a measurement module 
with a lot of connectors, a separate display module 
with touch keys, a USB cable, a temperature sensor 
with a short cable, and a separate small cable for powering 
the display (Figure 1). 


Figure 1: All of this hardware is included in the little box. 
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Figure 2: The measurement module with the top cover unclipped. 


A lot of current 

The version described here is suitable for DC voltages of up to 100 V 
and currents of up to 30 A. There is also aversion that can handle 
up to 100 A but, unless you want to make measurements on car 
batteries or the like, 30 A should be enough in most cases. The 
measurement module consists of a small plastic box with several 
openings in the cover. These allow you to connect the cables and 
the power supply to the screw terminals inside the box. 


The internals of the box consist of a sandwich of two PCBs 
(Figure 2). The top PCB holds all the screw terminals and a large 
relay while the bottom PCB contains the control circuitry and a 
2.4 GHz transceiver module for wireless communication with the 
display module. It looks a lot like an ESP8266 WiFi module but, 
as the chip is hidden beneath a drop of glue, we can't be sure. The 
top part of the enclosure can be easily unclipped to provide good 
access to the screw terminals. 


— 
"< 


TI9NOS 





The intent is that the module is fitted into a circuit or device where 
voltage and currentis to be measured. The measurement module 
requires an external 12 V supply voltage. The temperature sensor, 
if needed, can be connected to a small connector on the PCB. 


Display 
There are two options for linking the display module to the 
measurement module. You can use the included USB cable to 
connect it directly to the measurement module or you can use the 
built-in wireless connection. A wireless connection is established 
automatically if the USB connection is not available. According 
to the manufacturer, several modules can be used at the same 
time with up to 26 channels possible simultaneously. Obviously, 
when using the wireless connection, the display module must be 
provided with its own supply voltage. This can be achieved using 
the micro USB port (5 V) or via a two-way JST connector (8-16 V) 
for which a matching cable is included. 








The display measures approximately 3 x 2.5 cm and is very bright, so 
it is easy to read even under high ambient light conditions. There are 
three touch-sensitive buttons next to the display. By default the display 
shows the measured voltage and current together with the time at 
the start of the measurement cycle. A battery icon can be displayed 
on the left to indicate the remaining battery capacity after a nominal 
battery capacity has been entered. The connection mode, relay state 
and measured temperature are shown at the top of the screen. 


Even more information appears when you touch one of the buttons. 
This adds the display of the supplied or consumed power beneath 
the voltage and current. Ina further, smaller area you can see how 
many ampere-hours the power source or battery has supplied, the 
number of watt-hours, and the elapsed usage time. On the right there 
is a list with a number of menu items that you can scroll through 
with the up and down keys. We cover these in more detail shortly. 


Potential applications 

This set of display and measurement modules can be used for 
various purposes. For example, you can measure the current 
suppled to a load by a power source. If the power source is a battery 





Figure 3: The load on the output can be replaced by a battery charger. Measurements can be made in both directions. 
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Wireless VA 


Figure 4: The display module showing the default screen. 


primary or rechargeable), you can use this to keep track of how 
many ampere-hours it has supplied. You can also work in the 
opposite direction, with the load replaced by a battery charger. 
This then shows how much energy has been supplied to the battery 
Figure 3). 


There are a number of menu settings that are especially interesting 
for use with rechargeable batteries. For example, the upper and 
lower limits for switching off the relay can be defined. This can be 
used to avoid deep discharging of the battery when it is powering 
a load, or overcharging when it is being charged. You can also set 
amaximum positive current (from the power source to the load) 
and a maximum negative current (from the charger to the battery) 
for switching the relay. With this combination you can easily keep 
track of how much power a connected circuit uses, or how much 
energy was stored in a battery during charging, without having to 
resort to a calculator. The battery icon can also be hidden if you do 
not need it in a particular application. 

















Practical experience 
The JOY-iT user guide included with the device provides enough 
information to get you started, but to learn how to use all the 
features properly we recommend that you try each functionality 
in the list of menu items. 








The measured voltage and current are shown on the display with 
two digits before the decimal point and two digits after (Figure 4 
and 5). According to the user guide, the accuracy is +2% for voltage 
and +5% for current. This turns out to be reasonably correct ina 
comparison test with an accurate multimeter. Unfortunately the 
display module shows a small voltage even without an input voltage 
applied, which is a pity. Although it is within the 2% accuracy speci- 
fied, it does seem a little strange. 








The connector PCB in the measurement module has a jumper with 
positions marked 2W and 3W. This jumper is not mentioned in the 





05.96V 
00.97A 


00.193AH 
42°C 01.152WH 
00/00:12:20 


Wireless VA — meter 


Figure 5: After touching a button, a more detailed display including a menu 
appears. 


user guide instructions for this module. A little bit of searching 
revealed that it is used for selection of the external 12 V supply 
voltage. In the 3W position an external 12 V supply is necessary 
for operation of the measurement module. In the 2W position the 
module can derive this voltage from the connected power source, 
as long as the voltage is between 10 V and 30 V. The module tested 
functioned down to 8 V. 


The wireless connection is very convenient for keeping an eye on 
something froma distance. I powered the display module from a 
small powerbank, allowing me to walk around the house with the 
module. You have to be careful with the distance (10 m max.) since 
the range drops quickly if there are a few walls between the display 
and measurement modules. However, the display module includes 
a signal strength indicator that makes it easy to monitor this. 





Conclusion 
This set of measurement and display modules is very handy and 
affordable for measuring voltage and current in all sorts of circuits. 
Thanks to the large current range (30 A), it is ideally suited to situa- 
tions with high current levels. The ability to use the wireless display 
module in one location, while measuring the data somewhere 
else, is a valuable extra feature that you would scarcely expect at 
this price. This combination of capabilities is certainly worth the 
price of around €40/£35/$45. M 
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= RELATED PRODUCTS 


> JOY-iT VAX-1030 Wireless Multimeter 
www.elektor.com/joy-it-vax-1030-wireless-multifunction-meter 
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New® CR Meter 
50 Hz -2 MHz (Part 2 


Operation, Calibration, and Firmware Programming 





By Jean-Jacques Aubry (France) 


The measurement principle, the calibration in software and the hardware of this new LCR 
meter was discussed in the first part of this article series. In this second and final part, we will 
cover the user interface, the calibration, and firmware programming of the AU2019. 


Stand-alone mode 


In Part 1 of this series, we saw how the AU2019 
works, how it measures impedances, the 
calibration and compensation principles used 
and the hardware needed. Now it is time to 
have a look at this LCR meter from a user's 
point of view. 


Operating the LCR meter 

The AU2019 can be used as a stand-alone 
measurement device, using its LCD, the 
rotary encoder and buttons, but it can also 
be operated by a computer via a USB-link. 


If the device is fitted with the display exten- 
sion, it can operate independently, without 
a computer. In this mode, it starts automati- 
cally when using an external 5 V USB power 
supply. However, if it is being powered from 




















Table 1. 

50 60 Hz 
100 120 150 200 250 300 400 500 600 700 800 900 Hz 
1.0 1.2 1.5 2.0 2.5 3.0 4.0 5.0 6.0 7.0 8.0 9.0 kHz 
10 12 15 20 25 30 40 50 60 70 80 90 kHz 
100 120 150 200 250 300 400 500 600 700 800 900 kHz 
1.0 1.2 1.5 2.0 MHz 
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a PC, but you still want to use it in stand- 
alone mode, you'll need to press the upper 
button on the keypad while powering it up. 
(The new mode is memorized and no further 
action is required for the next start.) The 
same action is needed for returning to the 
PC mode. When the measurement screen 
is displayed, the rotary button changes the 
measuring frequency to one of 54 predefined 
values (Table 1). 

A long keypress on the rotary button allows 
you to enter a user defined frequency. The 
digit to be changed is selected using the top 
two buttons, and the rotary button changes 
its value, After validation, it is this value that is 
used (it is displayed in negative) and cannot 
be changed by the rotary button. A new long 
keypress on the rotary button is required to 
exit this mode. If the value is backed up, it will 
be offered in the next request. 


Button labels are displayed on the screen and 
changed to the settings you choose. For some 
buttons the action depends on whether they 
are pressed short or longer. In the latter case, 
the screen flashes briefly to signal that this 
state is detected. 


> The first (upper) button switches 
the component representa- 
tion: From AUTO (default mode) 
to SERIES or PARALLEL. 

> The second button [TRIM] initiates 
the TRIM procedure for the current 
frequency (OPEN or SHORT accord- 
ing to the measured impedance). A long 
press initiates the procedure of saving 
all TRIM actions taken since the last start. 

> The third button [AVG S] or [AVG F] 
allows you to change the number of 
measurements used (average) for the 
display, and thus the responsiveness 
of the instrument. It acts as a switch 
between Slow display (Average SLOW 
is displayed) and Fast display (Average 
FAST is displayed). NOTE: This feature 
is introduced from version 2.0.0 of the 
firmware and most screenshots were 
made before the software was updated! 

> The fourth button [R-HOLD] allows you 
to toggle freezing the current range. A 
long press toggles display of the meter’s 
settings: the range (R1..R4), PGA gain in 
voltage (Ux) and current measurement 
(Ix) respectively (with x = 1, 3 or 10). 

> The last button [MENU]: Short keypress, 
for access to the User Menu (measure- 
ment parameters), a longer keypress 
opens the calibration Menu. 


Q limit for secondary display 
Sorting parameters 


BNE 


a EXIT 
i L 
E48 -> 28 
E96 -> 18 

E 

c EXIT 

3.0512 I 
ENN | 
E 
e EXIT 


DC Bias voltage: 0 to SU 


DC 2.1 U 


EEE 


K 


step = 0.1 U 


Q 
m 
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Figure 1: The User Menu. 


User Menu (Figure 1) 

> Language (1a) 

Selection of the language used for the menus. 
The current version supports English, French, 
German and Dutch. 

> Q limit for secondary display (1b) 
Selecting the value of the Q (= 1/D) above 
which the secondary setting is not displayed. 
Possible values are: 

100 200 500 1000 2000 5000 no limit 

> Sorting parameters (1c) 

This menu lets you select the parame- 
ters (tolerance and value) used for sorting 
components. The value proposed will be 
that of the primary parameter of the refer- 
ence component connected before going 
into menu mode. These parameters will be 
memorized. The first step (1c) allows you 
to select the standard tolerance, from E6 
(20%) to E96 (1%) series. The second step 


Q = 500 


-BEE 


m ¢ 
5 


Select normalized value 


3.00 kR 


-FEE 


m 
= 


S00mU RMS 
200ml RMS 
100mY RMS 


“ae 


2 


OC Bias current: O to 50mA 


OOO 





step = 1 mA 


m 
= 


(1d) allows you to select the standardized 
value in this series. 
> Sort (1e) 
This menu starts the comparison, with the 
display of the measured value (top), the 
upper and lower limits, and of course if the 
test PASSes or FAILs. 
> AC level (1f) 
This menu selects the amplitude of the test 
signal without load. Possible values are: 
100 mV 200 mV 500 mV 1V (RMS) 
> DC bias (1g/h) 
This menu adjusts the value of the voltage 
(for capacitor) or current (for inductance) of 
DC bias. Possible values are: 

- 0 to 5.0 V, in 1 V or 01V steps 

- 0 to 50 mA in 10 mA or 1 mA steps 


Pressing the rotary button changes the value 
of the step. 
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Set sine generator offset 


Measured value of Vref (DDS) 
CMRR of Voltage diff. opamp 
PGA2: gain 3 calibration 

PGAZ: gain 10 calibration 
Calibration of the range 1 
Calibration of the range 2 
Calibration of the range 3 
Calibration of the range 4 

a <Short-circuit> Trim, all freq. 


EEE 


Freq: 


1 MHz 


J9 & J17 closed, J8 open 
Adjust R31 for minimum voltage 


0.29 mU 


OOO | 


O 


Figure 2: The Calibration Menu. 


For inductances, after validation and a few 
seconds for the stabilization, the actual value 
of the current is displayed under the label 
<DC>, because it depends on the resis- 
tance of the DUT. The label of the second 
button changes, because the TRIM is no 
longer possible with DC-bias. It changes to 
BIAS 0 and pressing the button will switch 
off the bias. 


Calibration menu (Figure 2) 

All calibration steps of the device are acces- 
sible in the menu. If the first-time calibra- 
tions are performed, it is recommended to 
run them in the menu order. Use jumpers with 


ece LCR Meter AU2019 version 1.2.2 


AUTO SERIES 

Z 3.052 kQ 

Q 0.0049 R Hold 
> -283.6 m° AC 
Vx 961 mV DC 
Ix 315 pA 


Freq 


Measured voltage on TP6 


1.180 ¥ 


nn 


10 kHz 

J9 & J1? closed, J8 open 
Adjust C44 for minimum voltage 
36.91 mY 


Freq: 


OO | 


x 


gold-plated contacts to minimize parasitic 
resistance and disconnect all cables from 
the BNC connectors. The complete calibra- 
tion procedure is described in the download- 
able documentation [1]. It is not difficult at all, 
and requires only a multimeter, configuration 
jumpers and a small trimming tool... and a 
bit of patience because at some steps it will 
take several minutes. We will only give you 
an overview here. 


> Set sine generator offset (2a) 

> Measured value of Vga (DDS) (2b) 

> CMRR of voltage differential opamp 
(2c/d) 


3.052 kQ 


2.58 pF 


100 kHz 


OFF 
1V RMS. TRIM 
0.0V 

RUN 


Figure 3: Controlling the LCR meter via the AU2019 app. 
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The following steps will take quite some time. 
At the end of each step saving of the new 
values must be confirmed. Please note that 
older parameters will be erased, even if the 
new values are NOT saved. 


> PGA2: gain 3 calibration followed by 
gain 10 calibration 

> Calibration of the ranges 1 to 4 

> <Open-circuit> Trim, all freq. 

> <Short-circuit> Trim, all freq. 

At the end of calibrations remove all jumpers 

and connect the Kelvin cables or the test 

fixture to the BNC connectors. Repeat 

the open- and short-circuit Trim proce- 

dure to take in account the new parasitic 

components. 


Before a test, at a given frequency, it is possi- 
ble and even recommended to make the two 
corrections TRIM by pressing the correspond- 
ing button (the second). New settings (as well 
as those at other frequencies) can be backed 
up by a long keypress of this button. 


Error checking 

During the firmware start-up sequence, 
some checks are performed. First, the 
Bootloader checks the integrity of the 
firmware in memory. Then the firmware 
checks for valid language data in high 
memory and verifies the supply voltages. 
If the power supply check fails, the 
message “Power supply Test Error, code 
A’ is displayed and the program loops on 
a sequence with the D12 LED turned on for 
Y s and off for 1 s. Each bit of the binary 
equivalent number of A shows the state of 




















Table 2. 
3 The bit is 0 if the 
Bit 
Ux | measured voltage 
number : 
is 
1 -5V | -5.3V < Ux< -4.7V 
2 +5V | 4.7V < Ux <5.3V 
3 +3V | 2.85V < Ux < 315V 
4 +6.5V | 6.29V < Ux < 6.68V 
5 +7.5V | 7.30V < Ux < 7.60V 











one of the verified supply voltages: 0 if the 
voltage is correct, otherwise 1 (Table 2). 


PC Mode 

Start the device in PC mode (“Waiting for 
the GUI...” is displayed), and a few seconds 
later start the AU2019 program on the PC 
(Figure 3). In the Port menu, select the correct 
serial port, then click the Open port button. 
Once the communication is established, the 
firmware version will be displayed to the right 
of the LCR Meter AU2019 app version. After a 
short time, all parameters of the DUT will be 
displayed. The buttons act as for the stand- 
alone mode. 


Some menus are specific to the PC mode, 
others are the same as those of the stand- 
alone mode, all this is explained in the 
documentation. There are also instructions 
for firmware and menu text updates. A full 
description can be found in the Operating 
instructions document [1]. 


How to measure components 
Test fixtures have a predominant influence 
when measuring at the end of the measur- 
ing range and/or at high frequencies. Special 
attention will be paid to the TRIM procedures. 
In order for the measurement to be accurate 
when the DUT is a low inductance or resis- 
tance, it is important that the TRIM short-cir- 
cuit compensation is performed just before 
the measurement is made. The same goes 
for low capacity, in this case with the TRIM 
open-circuit compensation. 


Resistor (Figure 4) 

In most cases, resistors can be measured 
with a good multimeter! On the other hand, 
it may be interesting to know the parasitic 
series inductance of a low ohm resistor at 
high frequencies, or the parasitic capacitance 
of high value resistor. 


Fi 1.069 nr EE 


TRIM 
AUTO 10 kHz 
Z= 14.89 k Ux = 1000 m | 
Ix = 67.3 pA R-HOLD 
R-Hold OFF 
a pc iw Ans DC 0.0 V MENU 


Figure 5a: Measuring a small capacitor at higher 
frequency. 


b 


COMPARISON WITH COMMERCIAL EQUIPMENT 


Of course, it is a good idea to compare this A2019 LCR meter with commercially 
available equipment. Unfortunately, neither the designer nor the Elektor Lab had 
equipment available to do a comparative test and even worse: it is very difficult to 
find an LCR meter with measuring frequencies up to 2 MHz. With the kind help and 
assistance of Alfred Rosenkranzer, the AU2019 was compared to a Hameg HM8118 
and an HP/Agilent 4263B and a handheld Keysight U1732A, the Hameg with the 
highest measuring frequency of 200 kHz. His overall conclusions are the following: 


The AU2019 has become quite a good measuring device. At some points it has 
difficulties (for example, with small coils at 100Hz measuring frequency). This is 
certainly not the ideal frequency to measure such small coils, the Hameg and HP 


produced quite sensible values there. 


It is nice that you can buy the Kelvin cables and the TH26001A 4 terminal test 
fixture very cheaply on Ebay, but it is difficult to say how good the quality is. A good 
connection between component and LCR meter is the key to a stable measurement. 
The 16047E test fixture (same type of device as the TH26001A) is very useful. 


It can be said that the overall accuracy of the AU2019 is 1%, and up to 0.1% for values 
in the middle of the measurement range, by selecting the correct measurement 
conditions in relation to the type and value of the component. 


Capacitor (Figure 5) 

For a capacitor it is possible to superimpose 
a DC voltage between 0.0 V and 5.0 V on the 
test signal, see the paragraph on DC bias. The 


positive terminals of this bias voltage are J4/ 
J5. Capacitance must be the dominant part of 
the impedance, otherwise the LCR meter will 
automatically switch off the DC-bias voltage! 


F> 96.40 mg 





AUTO 1.0 mHz AUTO 1.0 khz 
Z = 99.90 & Ux = 499 mu [ Z = 96.25 MR Ux = 1.01 U = 
g 3 paaa Ix = 5.05 mA a 3 = : Ix = 18.5 nA 
a en ee DC 0.0 U b E vas DC 0.0 Y MENU 


Figure 4a: Measuring low-ohm resistor at high 
frequency. 


Figure 4b: Measuring high-ohm resistor at low 
frequency. 


Fi 2.037 nr FA FSi 2.046 ar PARAL 
TRIM BIAS © 
AUTO 100 Hz AUTO 100 Hz pasg 
Z=781.4 mM Ux = 8.04 my a 2= 777.8 m Ux = 7.94 mU [ 
Ix = 10.4 mA R-HOLD Ix = 10.4 mA R-HOLD| 
R-HOLD R-HOLD 

R-Hold OFF R-Hold OFF 
AC 1U RMS pc 0.0 y MENU C AC 1V RMS DC 5.0 4 MENU 


Figure 5b: Measuring a large capacitor at low 
frequency. 


Figure 5c: Measuring a large capacitor at low 
frequency and 5 VDC bias. 
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22.52 pH |PARALU 500.9 ny PARAL 22.59 pH PARALL 
998.3 m2 24.84 mQ 1.01 2 [TRIM] 
BIAS Øl TRIM TRIM 
AUTO 40 khz insg AUTO 1.0 mHz AUTO 40 kHz [TRIM 
= 80.00 = Ix = 10.3 mA = 89.55 ° Ix = 9.97 mA = 79.93 ° Ix = 10.2 mA 
Be cso : m (ReHOLD Q = 126.2 R-HOLD =. y "A IR-HOLDI 
R-Hold ON R-Hold OFF R-Hold OFF 
oe 1U RMS pc 51.0 mA MENU] b AC 1U RMS oc 0.0 Y MENU c AC 1U RMS pe o.0 u MENU 
Figure 6a: Measuring an inductor with bias Figure 6b: Measuring an inductor at higher Figure 6c: Measuring an inductor without bias 
current. frequency. current. 
FIRST START OF THE DEVICE WITH Omen none a ci 
r Configuration 
A BLANK MICROCONTROLLER Part Number Hox Fle Location(s) | 
‘ 7 P C8051F120 X Not Banked [C:\Users\Administrator\D esktop\Merged CRE. hex B 
The first time you power up, you need a PC running EEES ea] A 
Windows and the USB Debug Adapter from Silicon | EEIT Sf RE E 
Labs (e.g. RS part no. 757-0297) for loading the CommonsBanka: | ig 
microcontroller firmware via the JTAG interface ere E EAA 
(J15). You must have downloaded the MergedLCR6. WA a aaae mde BS. D | I LogActionsToFie 
hex file, which is the file that includes both the wide Reve i Serial Increment || F A : 
š | Starting Serial Number: 1 Log File Name: 
bootloader (boot_LCR6.hex), and the firmware LCR6. we 0 Seine [MCUPegentest | 
hex. Procedures and detailed instructions are given F eee a] 0000 
in the Operating instructions document [1]. | F TRE Aroer o Raren 
4294967235 [4234967235 —=~C*~* 
| 
Load Settings... Save Settings... Accept Settings Cancel 








LOADING THE FIRMWARE 
FOR THE FIRST TIME 
Connect the USB Debug Adapter cable to J15 on the 


Figure 7a: Programming settings in Silicon Labs’s MCU Production Programmer. 


























B ESENS s a abi 
board and the PC and set SW1 to ON. Run the MCU e 
Production Programmer [3]: Curent Configuration — 
Past Number: Hex File(s) 
[cs051F120 C \Users Administrator Desktop\MergedLCRG hex | 
n : . Debug Adapter. | 
> Go to Program Menu / Configure Programming Information... and copy all ECaoo020005 | 
settings as in the screenshot below, then Accept Settings (you can save er ae 3 | 
. . : I elore progammi l 
these settings by Save Settings...) (Figure7a/b) pe Statin Sat 
? : . isistence Serialize Parts ure ‘ial Numt Increm 
> Click on Program Device to launch the operation. a go a a 


ater programming I BigEndien 


> After programming is finished, Device Programmed and Verified message 


appears in the Status Log window TE 
HARD 
> Then the display texts (language file) must be uploaded using the 
instructions in the Operating instructions document §4.2.5. sae i 


Debug Adapter. EC300020405 

Pest Number: C8051F120 

Erase Code Space: No 

Hex Fie (Not Banked): C:\Users\Administiatoe\Desktop\MergedLCR6 hex 
Flash Persistence: No 

Sesialize Pats: No 

Serial Number Code Locatior: 0x00000 
Uricade Format: No 

Serial Number Size (Bytes) 4 

Starting Senat N/A 

Serial Increment: N/A, 

Lock Code Space: No 





: aa p A 
Figure 7b: Silicon Labs’s MCU Production ia lig rA Stara Neo epee eae 
Programmer programming screen. z 
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= WEB LINKS 


[1] Documentation and Software Download: www.elektormagazine.com/190311-01 
[2] New LCR Meter Project Page on Labs: www.elektormagazine.com/labs/remake-lcr-meter 


[3] Silicon Labs Production Programmer Download: www.silabs.com/documents/login/software/MCUProductionProgrammer.zip 
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For the measurement of high value aluminum 
electrolytic capacitor, it is important to choose 
a test frequency that matches this technol- 
ogy and is less than its resonance frequency. 


Inductor (Figure 6) 

For an inductor it is possible to superimpose 
a DC current between 0 mA and 50 mA on 
the test signal (see paragraph 31.5 DC bias of 
the Operating instructions document). Care 
must be taken to ensure that the DC voltage 
developed in the internal resistance by this 
bias current is less than 0.3 V, otherwise the 
automatic offset circuit of the U7 differential 
amplifier can no longer work properly. 


NOTE: The application of 50 mA bias results 
in an increase of approximately 210 mA in the 
total current drawn by the device. Make sure 
that your power source can supply it. 


For small RF inductances, make sure the 
measurement is made at sufficiently high 
frequency, so that the dominant part of the 
impedance is inductive! M 

190311-B-01 


Also follow this project on the Elektor Labs project 


page [2], where the author also responds to questions 


and comments. 
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Idea, Design, Text and Illustrations: 
Jean-Jacques Aubry 


DETERMINING 
a COMPONENT TYPE AND 
EQUIVALENT CIRCUIT 


This device is designed to measure 

three types of components (resistors, 
capacitors, inductors) and for each of 

the types the conditions of measurement 
are to be chosen according to its value 
and its use. In addition to the value of the 
main parameter, which characterizes the 
component type, it also has a secondary 
parameter that depends mainly on the test 
frequency. The device evaluates the nature 
of the component based on its equivalent 
equation: 


inductive 





capacitive 


Z=Rs+jxs 
from which it calculates the quality factor: 


Q = |Xs|/Rs 








jx In AUTO mode the decision criterion for the 
definition of the main parameter and the 
equivalent circuit is the value of Q (=1/D) 
Figure 8. Equivalent circuit based on quality and the sign of the reactive component Xs, 
factor and reactive component. (source: see Figure 8 for the relationship between 
Fluke) Q, X, and equivalent circuit. 


Questions or Comments? 

Do you have questions or comments 
about his article? Email the author 
at jjacques.aubry@free-fr. 


RELATED PROJECTS 


> Elektor “Kickstarter” Project: 
Kit including Main Board + Display Extension Board + all parts 





www.elektor.com/Icr 
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Error Analysis 


Tips on Voltage Regular Circuits, PCB Design, and More 


Compiled by C. J. Abate (Elektor) 


Engineers, makers, and students can learn from 

their engineering errors, as well as from the mistakes 
of their peers. In our "Error Analysis" series, we let 
Elektor community members share their engineering- 


related errors and experiences. 


A Case for Voltage Regulator Circuits 


Have you ever spent hours on an electronics project only to have it 
all go “poof” due to a simple mistake? Scott Coppersmith — a Senior 
Research Engineer at the University of Notre Dame in South Bend, 
Indiana, USA — has been there. He recently shared his experience 
and offered a tip. 


“I designed a lighting solution for my boat once by stringing 





LEDs inside clear tubing. I calculated the voltage at 13VDC based 
on measurements while the boat motor was operating. Then 
I made the mistake of starting the engine without the battery 
connected and every LED burned out in unison when the alter- 
nator output jumped to 21 VDC. Hours and hours of work — poof. 
Automotive and marine power systems can vary wildly from 8 
volts to 18 volts or more depending on charge state and load on 
the battery. It’s best to have your own voltage regulator circuits 
for these applications.” — Scott Coppersmith 








MORE ON VOLTAGE REGULATOR CIRCUITS, POWER SUPPLIES, AND LEDs 


Looking for additional info about power systems, LEDs, and voltage regulators? Check out these useful Elektor resources: 


> Voltage regulators (www.elektormagazine.com/tags/voltage-regulators) 


> Power supplies (www.elektormagazine.com/tags/power-supply) 


> C. Valens, “How to Calculate an ‘LED Resistor,’ ElektorMagazine.com, August 2019. (http://bit.ly/LED-resistor) 
> M. Heine, “LED Booster for Microcontrollers,’ ElektorMagazine.com, 2020. (http://bit.ly/LED-booster) 
> C. Valens, “Do You Know the Linear LED Driver?,’ ElektorMagazine.com, February 2020. (http://bit.ly/linear-LED-driver) 


All Components Are Suspect 


Looking for tips about printed circuit board (PCB) design? Chris Clapham 
is an Auckland, New Zealand-based hardware engineer with 30-plus 
years of experience working with PCBs. He offers some great advice: 
always check your components. Even new components can be faulty. 


“Never remove brand new components from the suspect list! While 
working for a TV PCB reconditioning company 30-plus years ago 
— where we not only repaired faulty PCBs, but they were recondi- 
tioned, electrolytics replaced, dry joints resoldered, etc., and any 
stressed looking components replaced — we came across a few 
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faulty but brand new components. These included transistors 
with their complimentary device in the package or their marking 
switched (not sure which) — that is, a PNP in a case with an NPN 
part number, efficiency diodes that measured nearly identical to a 
good one but did not work properly leaving the power supply to run 
very hot. We even had a diode which had the anode and cathode 
swapped. The device the TV manufacture had used (they got them 
cheap) had the cathode connected to the metal tab (TO-220 type 
case from memory) and that was connecting to the heatsink, 
which was grounded (no insulator) but the new part (correctly 
made) had the anode connected to the tab, so it shorted when 
fitted until you figured out that it needed a mica washer to make it 








work. Field 
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would replace 
the shorted origi- 
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be able to 
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it measured fine. A 
iode. The 
the board would not work. After checking everything several times 
tting advi 
compared to a working PCB the meter leads had to be swapped to 
get the diode to conduct. The Diode was in the PCB the same way 
the junction inside the case was reversed. So now I 
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G Never remove brand new 5 5 must be in the circuit the right way 


components from the suspect list! 


board was still faulty. If they took out the new diode, 








nd the other diode incident was a DO-201 


shorted diode on the PCB was replaced, yet Share Your Error Analysis 


ce from a work mate, we noticed that when 


know that I need to check that the diode not only conducts one 


MORE ON PCBs, PCB DESIGN, AND PROTOTYPING 


Want tips and insights about PCB design and prototyping? Consider these Elektor resources: 


> ElektorTV, “PCB Layout with Pcbnew,’ 6/5/2020. (https://youtu.be/-_nZZLuwYd0) 

> C. Valens, “More 3D Libraries for KiCad EDA,’ Elektor, 10/7/2019. (www.elektormagazine.com/news/kicad-3d-library) 

> Elektor, “ElektorPCB4Makers: Your Affordable, Environmentally-Friendly PCB Service,’ 1/23/2020. 
(http://bit.ly/ElektorPCB4makers) 

> KiCad Plugins and Add-ons (hittp://bit.ly/kicad-plugins) 

> Schematic Capture with Eeschema (http://bit.ly/kicad-Eeschema) 


(despite the case or PCB marking 
)."—ChrisClapham M 


200562-01 


Want to share details about your electronics-related errors 
and learnings? Simply fill out our “Error Analysis” form. 
Professional electrical engineers, makers, and EE/ECE 
students are welcome to contribute. 
www.elektormagazine.com/news/error-analysis-submission 








lives and the way we spend our time. 





elektor.com/authors-wanted 


Authors Wanted 


Covid-19 has had a considerable impact on all our 


As a consequence, if you find yourself with time on 
your hands, why not consider sharing or even selling 
some of your expert knowledge with Elektor. We at 
Elektor have the know-how and resources to help 
bring your video course, article, or book to life. 


Send us your idea, and we'll get back to you. 


(©lektor 
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ELEKTOR ETHICS 





The Open Hardware 


Observatory 


Community-Based Open Source Hardware Assessment 


By Tessel Renzenbrink (The Netherlands) 


The Open Hardware Observatory is an initiative that aims to make open hardware more 
accessible. It provides a search engine to help you find open hardware projects published 
anywhere on the web. And it is currently developing a community-based platform for 
reviewing open source hardware documentation based on DIN SPEC 3105. The Observatory 
is being developed by a group of people from Open Source Ecology Germany e.V. and TU 
Berlin. Lukas Schattenhofer — together with Consuelo Alberca Susano, Mehrdad Mansouri, 
and Nils Weiher — is currently working on the community around the Observatory. 
Schattenhofer explains how it works and invites Elektor readers to join the community. 


Open-source hardware (OSH) is hardware whose design is made publicly 
available so that anyone can study, modify, distribute, make and sell 
the design or hardware based on that design [1]. To understand the 
benefits of open hardware, we would have to change our perspective 
on technology, says Lukas Schattenhofer. “For most people, technology 
is currently something you consume rather than build and maintain. If a 
component of their phone breaks, they buy a new one instead of fixing 
it. Today, most technology is closed. That means that the information 
you need to make repairs isn't accessible. But if all the documentation 
is available, you wouldn't need to buy a new phone every two years. 
You would be able to repair it and even build it. Also, it would change 
the way products are designed. They would become more modular so 
you can swap out parts and combine products with each other” 


“Documentation /s the source” 

But even though there is a thriving open hardware community, OSH 
is still much less known than its counterpart open-source software. 
The Open Hardware Observatory (OHO) aims to make OSH more 
visible by providing an online repository of open projects [2]. To 
do so, OHO has created a search engine that crawls the web for 
projects. These are listed with photos and a short description. But 
not all the projects in the repository are truly open. That is where 
the second branch of OHO comes in — the assessment platform. 
It helps makers present their project in such a way that it complies 
with the standards for OSH. 


There are two main criteria for a project to be open. First, there are 
the licenses. Code or firmware is automatically copyrighted. If a maker 
includes software in their project, they must actively assign it an open 
license like the Gnu General Public License or the MIT license [3]. 
Product documentation, especially when it is extensive, often falls 
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under copyright law too. Not all makers are aware they have to explicitly 
assign an open license to enable downstream users to legally re-use 
the code or distribute the documentation. 


The second criterion concerns the documentation. Schattenhofer: 
“Documentation is important. OSH is about enabling people to study, 
modify and make the hardware. And for that you need the designs. 
You can't download the source code as you do with software. With 
hardware, the documentation is the source.” 


Therefore, documentation needs to be in compliance with a minimal 
set of requirements. An enthusiastic maker who's uploaded a Youtube 
video of their DIY drip irrigation system probably wants to share it. But 
if the video lacks the information needed to reproduce the project, it 
isn't really open source. 


Documentation assessment platform 

Schattenhofer and the team are currently working on the assess- 
ment platform. The review process works as follows. An applicant 
uploads a project. Three reviewers assess the documentation. They 
can add comments to point out which parts are missing or should be 
improved. When the documentation meets all the requirements, the 
project receives an attestation. 


The requirements for the documentation are laid down in DIN SPEC 
3105. This is a Publicly Available Specification submitted to DIN, the 
German standards body. It specifies concrete measurable criteria for 
OSH compliant documentation. The specification is itself the result 
of a collaborative process of the OSH community. And in accordance 
with open source principles, anyone can contribute to the further 
development of DIN SPEC 3105 via the Gitlab page [4]. 





There already is an OSH certification process facil- 
itated by the Open Source Hardware Association 
(OSHWA) [5]. It too is the result of the need felt by 
the OSH community to have clear guidelines to 
determine whether a project is truly open. But the 
OSHWA certification process focuses mainly on 
the licensing aspect of open. What was still lacking 
were requirements for the documentation side of 
OSH, or in other words a clear definition of what 
constitutes a source. OHO’s assessment platform 
based on the requirements laid out in DIN SPEC 
3105 seeks to remedy that gap. 





Join the community 

The assessment platform is already up and running 
but still under development. The developers received 
feedback from the community asking for a more 
intuitive workflow. So they are currently working on 


PROJECT 
>>>) LIFECYCLE 


The Open Hardware Observatory (OHO) aims to make OSH more 
visible by providing an online repository of open projects. 


improving the user experience. Schattenhofer and the team are inviting 
Elektor readers to join the OHO community. You can join by uploading 
your project for review. Or you can apply your technical knowledge as a 
reviewer. But, Schattenhofer warns, you should be ready to deal with a 
website that is not entirely ready yet. So there's a third role you can take 
on in the OHO project. You can get involved as a tester of the platform 
and help to create a better user interface and workflow. 


Schattenhofer: “At the moment, not many people know DIN SPEC 3105 
and the community-based assessment platform yet. But we want to 
build an active community around the Open Hardware Observatory to 
advance mainstream adoption of open source hardware. People who 
join the OHO community now, can really be part of the development 
process. If you get involved now, you can bring in your own ideas. If 
you are interested in joining OHO, you can contact us at info@ohowiki.’ 


Contributors 
Text: Tessel Renzenbrink 
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Schematic overview of the community-based review process of open-source hardware 
documentation. (Image: Courtesy of the Open Hardware Observatory) 


Note: OHO was founded as a collaboration between the non-profit 
association Open Source Ecology Germany e.V. (OSEG) and the 
French-German research project OPEN! Methods and tools for commu- 
nity-based product development [6]. 14 

200560-01 


Questions or Comments? 

Do you have questions or comments regarding this article? 
Then get in touch with the Elektor editorial team at 
editor@elektor.com. 


Layout: Giel Dols 





[1] This widely used definition was established by the Open Source Hardware Association (no relation to OHO). 


[2] Open Hardware Observatory: https://en.oho.wiki/wiki/Open_Hardware 


[3] List of Open Licenses: https://opensource.org/licenses 
[4] DIN SPEC: https://gitlab.com/OSEGermany/OHS/ 


[5] Open Source Hardware Association Certification: https://certification.oshwa.org/ 


[6] Founding Partners: https://en.oho.wiki/wiki/Founding_partners#TU_Berlin_.2F_Research_project_OPEN.21 
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INTERVIEW 





ava on tne 
Raspberry PI 


An Interview with Frank Delporte 





By C. J. Abate (Elektor) 


You can run Java on the Raspberry Pi. In this interview, Elektor author 
Frank Delporte covers the benefits of Java, his Raspberry Pi-based projects, 
and much more. 





Want to run Java on the Raspberry Pi? 
Belgium-based Frank Delporte can help. His 
new book, Getting Started with Java on the 
Raspberry Pi [1], is an excellent resource for 
both professional programmers and makers 
interested in experimenting and learning at 
their own pace. In this interview, Delporte 
talks about the benefits of combining Java 
and Raspberry Pi, as well as his experiences 
as a programmer. 


Programming, designing, 
and writing 


Abate: Congratulations on publishing 
the book, Getting Started with Java on the 
Raspberry Pi (Elektor 2020). I will ask more 
about the book in a bit. But first: are you 
happy to have all the writing and editing 
behind you now? Or do you enjoy that sort 
of work? 


Delporte: I really love to write as you can 
see on my blog [2]. But I have to admit a full 
book was a lot of work. It requires not only 
the writing itself, but also collecting all the 
required information, research, setting up 
experiments, drawing eletronic schemes, 
doing interviews, re-reading, etc. But the 
feeling of holding your first finished printed 
paper book (Figure 1) is a once-in-a-lifetime 
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experience which was really worth all the 
hard work. 


Abate: Speaking of your writing and editing 
work, we featured your home workspace 
[3] on the Elektor magazine website in May 
2020. Are you still working from home due 
to the COVID-19 situation? 


Delporte: The situation is more-or-less 
back to normal now. I still work at home 
but not really for Covid. At work, we can 
keep enough distance, but from time to 
time, it’s still better to work home so you 
can focus on a specific task. 


Abate: You have an interesting background, 
which includes work as a software devel- 
oper, technical lead, author, and video 
editor. Tell us more about yourself. 


Delporte: I've always been interested in 
technology and how things work. I was 
the kind of kid that opened every coffee 
machine, radio or whatever device which 
was broken. I wasn't able to fix them all, 
but I learned something new every time! 
Asa teenager I hada radio show ona local 
station and did some DJing which gave me 
the possibility to experiment more with 
electronics. 





Getting Started with Java 
on the Raspberry Pi 





OpenJDK € spring 
JavaFK áru 








Figure 1: Delporte’s book, 
Getting Started with Java 
on the Raspberry Pi. 


That’s why I decided to study at a (techni- 
cal) film school were we learned how film, 
radio and television are produced, how 
you calibrate cameras and connect all the 
devices and recordings together. After I 
graduated, video production changed a lot 
when computer editing got introduced, and 
that’s how I got into programming again 
when clients wanted their company video 
on CD-ROM and Internet. 








Abate: In your bio, you mention the 
Commodore 64. Do you remember any of 
your early experiences with it? 





Delporte: I only had one game on my 
C64, because I really got more interested 
in programming. Thanks to Elektor, I 
found a book (must be around 1987) with 
an electronics board with eight relays you 
could control with the C64 and Basic. I 
used it to control my Lego train and used 
magnetic switches to detect the position of 
that train through the joystick ports. That 
was the first time I managed to combine 
software and hardware. Nowadays, sucha 
project would be a lot easier (and cheaper) 
with Arduino or a Raspberry Pi and the 
many great extension boards. 








Abate: What were your career goals in 1994 
when you left NARAFI Nationaal Radio en 
Filmtechnisch Instituut in Belgium? 


Delporte: My first job was video editing 
at alocal TV station, and after a few years, 
Istarted doing the same as a freelancer. I 
never had a clear career goal but rolled from 
job to job and learned new things along 
the way. That’s how I transformed myself 
from video editor to multimedia devel- 
oper building company presentations on 
DVD and CD-ROM. And when the Internet 


Figure 2: The LED strip setup. 


started taking off, I switched to web devel- 
opment as my customers wanted to share 
the same information on websites with a 
content management system. And with 
that knowledge, I grew into Java develop- 
ment and technical lead doing product 
development using that technology. 


Teaching code 


Abate: When did you start organizing 
CoderDojo sessions? And what sort of 
courses do you teach? 


Delporte: In every company I've worked, it 
has been a challenge to find good techni- 
cal colleagues. Engineering (and definitely 
IT) is still a too male environment. To me, 
engineering is magic. With a few lines of 
code or a few electronic components, you 
can build “stuff.” [wondered why kids — who 
love to build and experiment — suddenly 
stop doing this and don’t choose a study 
where they can continue “making things.” 


CoderDojo [4] is a free club where volun- 
teers help children from seven to 18 to 
experiment with “digital stuff.” We use 
Scratch (block based programming) for 
programming, build worlds in Minecraft 
with JavaScript, control electronics with 
Arduino, build robots with Lego, and much 
more. In 2013, I started such a club in leper 
and Roeselare and still lead the one in Ieper 
— except now during Corona times, as it 
is difficult to organize such informal clubs 
when you have to keep a safe distance and 
can not gather around a PC with different 
people. Thanks to CoderDojo and other 
STEM (Science, Technology, Engineering 
and Mathematics) initiatives, we see a 
slow increase in the number of engineer 
students — boys and girls! 

















Abate: At which point did you realize, “Hey, 
I'ma good instructor/teacher, and I think 
I can help others interested in Java”? Or, 
did a friend or colleague point you in that 
direction? 


Delporte: I like to explain things and 
strongly believe in “learn by teaching.” 
That’s what I do at CoderDojo with children, 
but also with my blog and at work. To fully 
understand a topic, you must be able to 
explain it — or vice versa. The articles I 
write for my blog are always the result of 
something I want to try out but don't really 
know how to do it (yet). During the process 
of figuring it out, I write down the steps I've 
taken and what worked and didn’t work. 
That’s how I learn new stuff and can share 
that knowledge with others. 








A focus on Java 


Abate: Tell us about your history with Java. 
Did you first learn it out of curiosity? Or was 
it for a class? Or for work? 


Delporte: When I started developing multi- 
media applications, I had to learn Action- 
Script (and even Lingo before that). Later, I 
changed to C# and SQL for the web applica- 
tions. As you may now know already, I learn 
by experimenting. But also from reading 
books and short (on-line) courses. When 
I started at Televic Rail in 2010, I joined a 
team which was already using Java. Switch- 
ing from C# to Java was very easy. After all 
these years of programming, I have to say 
Ilearn the most from colleagues! Sharing 
your work with others in presentations, 
improving the code with pull requests, 
accepting comments as how you can do 
things better are all the best ways to learn 
from others. 
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Figure 3: The drum booth controller's installed components. 


Since I started experimenting with Java 
on Raspberry Pi, I got involved in some 
open-source projects and discussions, and 
that’s a complete new world to me, where 
I meet a lot of very bright people who are 
also willing to share their knowledge and 
experience. Still every day I’m amazed by 
the stuff you can learn from these projects 
and people. You don't have to contribute 
code, but you can also join such a project 
by reviewing pull requests, helping to test 
or document the code. 





Abate: Are you anti-Python or anti-C? I 
assume you aren't, but I have to ask. 


Delporte: Definitely not! I hate haters. 
There are no bad programming languages! 
I once read a quote which says, “The best 
tool for the job is the one you know the 
best.” In my case, that’s Java and JavaFX if 
I want to make an application with a nice 
user interface. But in my book, I also used 
Python to control a LED number display 
and an Arduino with LED strips. 


For each project (Figure 2), you must make 
a decision what the best tool, programming 
language or framework is. And once you've 
decided, go for it! Maybe you'll realize later 
you didn’t make the best choice, but at least 
you will have learned new things. 


Working with Java on the 
Raspberry Pi 


Abate: You have been blogging about technol- 
ogy since 2007. It looks like your first post 
about Rapsberry Pi was “Pong ona Raspberry 
Pi” [5] (December 2017). Can you tell us about 
your first experiences and projects with RPi? 
When did you get started with it? 


Delporte: When I started with CoderDojo, 
there were some coaches who already had 


eseseeeee? 
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experience with Arduino and Raspberry 
Pi. They brought there kits to the club, and 
I was really amazed of the power of these 
inexpensive boards and what you can 
achieve with them combined with small 
electronic components. 


was blogging already for some time, but 
my first “public” Raspberry Pi-project was 
indeed this Pong game that we used on 
some activities of the school of my son. 
I used Python for the user interface; but 
I have to be honest, I didn't like to code 
it very much. For that kind of applica- 
tion, I really prefer JavaFX for which there 
is even a very nice gaming framework: 
FXGL [6]. 





Abate: Do you have any RPi-based designs 
or applications running at home or in your 
workspace? 


Delporte: I started with Java on the 
Raspberry Pito builda drum booth control- 
ler [7] for my son. It’s a touch-screen user 
interface to control multiple lights with a 
relay-board and LED strips controlled by 
Arduino (Figure 3). 


This way I learned to use serial communi- 
cation between the two boards and I’C to 
control the relays. In my book, I extended 
this further and used a Mosquitto queue to 
exchange messages between more boards 
and PCs. 





Abate: What else are you working on these 
days? New projects, programs, or books? 


Delporte: I’m further experimenting with 
Java on the Raspberry Pi, of course. I wrote 
some more blog posts on this subject and also 
experimented with other Java technologies 
(Quarkus [8], Spring, GraalVM) and 64-bit 
operating systems on the board. 
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Figure 4: Rainbow effect selected for LED strips. 


Ialso joined the Pi4J-team. Pi4J is a frame- 
work and library to combine Java applica- 
tions with the full power of the GPIOs of 
the Raspberry Pi. This project was started 
by Robert Savage, and he was looking for 
extra team members to bring this project to 
a new generation which fully supports Java 
11+ and the Raspberry Pi 4 with Java modules 
and an easily extendable architecture. I'm 
really excited about the second version of this 
framework, which we hope to release soon. 





Abate: Let's return to the book, Getting 
Started with Java on the Raspberry Pi. Why 
did you write it? 


Delporte: When starting the drum booth 
project, I had to find out how to use Java on 
the Raspberry Pi, how to install the right 
version of JavaFX, how to control the GPIO 
and an Arduino, etc. That's when I wrote my 
first article [9], which was published in MagPi 
(July 2019, Dutch [10] and French [11] edition). 


Elektor contacted me and asked if this 
could be the subject of a book. As I couldn't 
find a recent one on this topic and Java 
had some major changes in the last years, 
this question really triggered me and the 
next day! started writing. It took me more 
than six months and a lot of evening and 
nights, but I really had fun while writing 
and experimenting. And, of course, I hope 
it's as much fun to read the book and try out 
the projects that I included. 


Abate: Do you have any advice for engineers 
or makers who are thinking about using Java 
for their Raspberry Pi-based designs? 


Delporte: Try it, really! Java is still one of 
the top programming languages world- 
wide. Whether you are an experienced 
Java developer or starting from scratch, 
there is a lot to learn and experiment when 





Java is not only a programming language, 
but also a virtual machine which runs the Java code. 


Frank Delporte 


you combine Java with a Raspberry Pi and 
electronic components. 


The examples in my book use very cheap 
parts like LEDs, buttons, LCD, LED number 
display, etc., so you may already have these 
available, or find them in any starter kit. All 
the book examples can be used to combine 
them to the project of your dreams. The 
drumbooth controller I made for my son is 
a combination of multiple of those examples 
(Figure 4). 


Abate: What has the feedback been so far? 


Delporte: Although Python was the initial 
language to be used on the Raspberry 
Pi (yes, that’s where the Pi comes from) 
and some still believe it’s the only right 
choice, I got a lot of positive feedback 
and questions on this topic. I even got the 
chance to write a post for the Oracle Java 
Magazine [12], which got a lot of readers 
and shares! There is a clear interest in 
this topic, and the future new generation 
of Pig] will make it even easier to build 
powerful applications. 
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[1] Getting Started with Java on the Raspberry Pi: www.elektor.com/getting-started-with-java-on-the-raspberry-pi 
[2] _WebTechie Blog: http://webtechie.be/ 


Abate: Is there a programming language 
that you don’t know that you plan to learn? 
Any hardware you're thinking of trying out? 


Delporte: Java is not only a programming 
language, but also a virtual machine which 
runs the Java code. On this same VM, you 
can also run Scala, Kotlin and many other 
languages. So still a lot to explore within 
this world. For the Pi4J project, I want to 
extend the example code and documenta- 
tion website, so I will need to set up multiple 
small hardware examples and learn a lot of 
new stuff myself. 


Programming success 


Abate: Let’s wrap up with your biggest 
engineering- or programming-related 
success. Is there a specific project (software 
or hardware) that stands out? What was diffi- 
cult about that project? What did you learn? 


Delporte: In my job at Televic, we use 
a combination of Java and embedded 
programming to connect multiple servers 
and data sources to bring real-time passen- 


[3] “A Software Developer's Space for DIY Projects and Writing”: 
www.elektormagazine.com/news/electronics-workspace-software-developers-space 


[4] CoderDojo: http://coderdojo.com/ 


[5] “Pong ona Raspberry Pi”: http://webtechie.be/post/2017-12-20-pong-on-a-raspberry-pi/ 


ger information to screens on whole sets of 
trains. Solving this technical challenge and 
finally walking through a driving train with 
100 screens showing the departing trains at 
the next station with real-time delays and 
platform changes is very satisfying. 
The flow needed to bring all this data 
through unreliable wireless connections 
(GSM signals aren't really designed to handle 
fast driving vehicles) is a real masterpiece of 
which I'm very proud we could realize with 
a small team. But I'm equally impressed by 
the children at CoderDojo who manage to 
make their first Flappy Bird game in Scratch 
orblinkaLEDwithArduino! M 
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[6] “Getting Started with FXGL Game Development”: http://webtechie.be/post/2020-05-07-getting-started-with-fxgl/ 


[7] “Drumbooth Controller with Raspberry Pi and JavaFX”: 
http://webtechie.be/post/2020-03-30-drumbooth-controller-with-java-javafx-raspberrypi-arduino/ 


[8] Quarkus: http://webtechie.be/post/2020-07-28-spring-versus-quarkus-rest-h2-db-on-raspberry-pi/ 
[9] WebTechie Articles: http://webtechie.be/articles/ 


[10] MagPi (Dutch): www.magpi.nl/ 
[1] MagPi (French): www.magpi.fr/ 


[12] “Getting Started with JavaFX on Raspberry Pi”: http://blogs.oracle.com/javamagazine/getting-started-with-javafx-on-raspberry-pi 
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Data Analysis 
and Artificial 
Intelligence in 
Python 


Interpreting real data with NumPy, 


pandas and scikit-learn 


The analysis and interpretion of data 

that originates from our surroundings 

and environment is a topic of increasing 
interest. Such data is now an established 
part of our everyday lives, ranging from that 
collected about our climate to data acquired 
during smart manufacturing processes. 

The quantity of data allows us, in theory, to 
characterize any phenomenon. However, 
dealing with it requires the mastery of many 
skills, both theoretical and practical. Here we 
examine some of these techniques and make 
use of Python for the analysis of this real- 
world data. 


By Angelo Cardellicchio (italy) 


Terms such as big data and artificial intelligence have become a 
permanent entry in our everyday language. This is primarily due 
to two factors. This first is the increasing and pervasive diffusion of 
data acquisition systems that has allowed the creation of virtually 
endless knowledge repositories. The second is the continued growth 
in computational capability, due to the widespread use of GPGPUs 
(general-purpose graphics processing units) [1], which has made 
it possible to tackle computational challenges whose resolution 
was once considered essentially impossible. 


Let's start with the description of an application scenario that 
will accompany us through this article. Let’s imagine having to 
monitor an entire production chain (the precise product does 
not play a role here). We have the ability to acquire data froma 
wide range of sources. For example, we can place sensors along 
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the entire production line, or make use of contextual information 
that indicates the age and type of each machine. This set of data, 
or dataset, can be used for different purposes. This could include 
predictive maintenance, allowing us to evaluate and predict the 
occurrence of abnormal situations, plan orders for replacement 
parts, or undertake repairs before failures occur, all of which result 
in cost savings and increased productivity. In addition, the knowl- 
edge of the data's history allows us to correlate the data measured 
by each sensor, highlighting possible cause /effect relationships. 
As an example, if a sudden increase in temperature and humidity 
of the room was followed by a decrease in the number of pieces 
manufactured, it may be necessary to make changes that maintain 
constant climatic conditions using air conditioning. 


The implementation of such a system is certainly not within every- 
one’s reach. However, it is simplified by the tools made available 
by the open source community. All that is required is a PC (or, 
alternatively, our trusty Raspberry Pi can be used, if the amount 
of data to be processed is not huge), a knowledge of Python (which 
you can deepen by following a tutorial like this [2]) and, of course, 
some knowledge of the ‘tools of the trade’. OK — let’s get started 
and discover them together! 


The tools of the trade 

Needless to say, we must be able to create programs written in 
Python. To do so, we will have to install the interpreter. This can be 
found on the official Python website [3]. In the rest of this article 
we will assume that Python has already been installed and added 
to the system environment variables. 


The virtual environment 

Once the Python setup is complete, it is time to set up a virtual 
environment. This is implemented as a sort of ‘container’ that is 
separate from the rest of our system and into which the libraries 
used are installed. The reason for using a virtual environment for 
the global installation of libraries relates to the rapid evolution of 
the Python world. Very often, substantial differences arise even 





between minor releases of the interpreter, resulting in libraries (and, 
consequently, programs) that are incompatible as they were written 
for different Python versions. By having a deterministic environ- 
ment where we know the version of each single installed library 
provides a sort of ‘guarantee’ that our programs will function. In 
fact, it will be enough to replicate precisely the configuration of the 
virtual environment and we can be sure that everything will work. 








To manage our virtual environments we use a package called 
virtualenvwrapper. This can be installed from the shell by using pip: 
$ pip install virtualenvwrapper 











Once the installation is complete we create a new virtual environ- 
ment as follows: 
$ mkvirtualenv ml-python 


Note that ml-python is the name of the virtual environment chosen 
for our example scenario. Obviously, such names can vary and an 
appropriate name can be chosen by the developer. We proceed 
next by activating the virtual environment: 

$ workon ml-python 





We are now ready to install the elements necessary to follow the 
rest of the article. 


Libraries 
The libraries that we present and use here are the five most-used 
for data analysis in Python. 


The first, and perhaps most famous, is Numpy, which can be consid- 
ered a sort of port of MATLAB for Python. Numpy is a library for 
algebraic and matrix calculations. As a result, those who regularly 
use MATLAB will find many similarities, both in terms of syntax and 
optimization. Using algebraic calculation in Numpy is, in fact, more 
efficient than nested cycles in MATLAB (to learn more, I leave you 
the link to this article [4]). Predictably, the type of data at the core of 
Numpy’s functionality is the array. This is not to be confused with 








the corresponding computer vector but should instead be under- 
stood in the algebraic and geometric sense as a matrix. Since data 
analysis is based on algebraic and matrix operations, Numpy is 
also the basis for two of the most used frameworks: Scikit-Learn 
(covered shortly) and TensorFlow. 


A natural complement to Numpy is Pandas, a library that manages 
and reads data from heterogeneous sources, including Excel 
spreadsheets, CSV files, or even JSON and SQL databases. Pandas 
is extremely flexible and powerful, allowing you to organize data into 
structures called dataframes that can be manipulated as required 
and exported with ease directly into Numpy arrays. 


The third library we will use is Scikit-Learn. Born from an academic 
project, Scikit-Learn is a framework that implements most of 
the machine learning algorithms used nowadays by providing a 
common interface. The latter concept is precisely that of object-ori- 
ented programming: it is, in fact, possible to use virtually every 
algorithm offered by Scikit-Learn through the fit_transform 
method by passing at least two parameters, such as the data under 
analysis and the labels associated with it. 





The last two libraries we will use are Matplotlib and Jupyter. The 
first one, together with its complement Seaborn, is necessary to 
visualize the results of our experiments in the form of graphs. The 
second offers us the use of notebooks, interactive environments of 
simple and immediate use that allows the data analyst to write and 
execute parts of code independently from the others. 








Before proceeding further, however, we will introduce some theoret- 
ical concepts that are needed to build a ‘common base’ for discourse. 


The concepts 
The first concept required is that of datasets, something that is 
often simply taken for granted. These are sets of samples, each of 
them characterized by a certain number of variables or features, 
that describe the phenomenon under observation. For simplicity 
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Figure 1: The home screen for managing notebooks in Jupyter. 
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Figure 2: An empty notebook. 





we can think ofa dataset as an Excel spreadsheet. The rows provide 
the samples, that is the individual observations of the phenome- 
non, while the columns provide the features, that is the values 
that characterize each of the aspects of the process. Returning to 
the example of smart manufacturing, each row will represent the 
conditions of the production chain at a given moment while each 
column will indicate the reading ofa given sensor. 


When we talked about Scikit-Learn, we briefly mentioned 
the concept of label or class. The presence or absence of labels 
allows you to distinguish between supervised and unsupervised 
algorithms. The difference is, at least in principle, quite simple: 
supervised algorithms require a priori knowledge of the class of each 
sample in the example dataset, while the unsupervised algorithms do 
not. In practical terms, to use a supervised algorithm it is required 
that a domain expert establishes the class of belonging for each 
sample. In the case of a smart manufacturing process, an ‘expert’ 
could determine if a set of readings, from a specific moment of time, 
represent an abnormal situation or not. Thus the single sample 
can be associated with one of these two possible classes (abnor- 
mal/normal). This is not necessary for unsupervised algorithms. 











Futhermore, a distinction must be made between processes with 
independent and identically distributed data (IID) and with datain 
achronological order. The difference is related to the nature of the 
phenomenon under observation. Samples of an IID process are 
independent of each other, while in a time series each sample 
depends on a linear or non-linear combination of the values that 
the process output at previous points in time. 














Let’s get started! 

With the necessary theoretical and practical terms covered, we 
move on to using a suitable dataset for our example case. The 
dataset used is SECOM, an acronym that stands for SEmiCOnductor 
Manufacturing, that contains the values read by a set of sensors 
during the monitoring of a semiconductor manufacturing process. 
In the dataset, which can be downloaded from different sources 
(such as Kaggle [5]) there are 590 variables, each of which is repre- 
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sentative of the reading of a single sensor at a given instance in 
time. The dataset also contains labels that distinguish failures and 
anomalies from the proper functioning of the system. 


Once the dataset is downloaded, we install the libraries mentioned 
above. From the command line, enter: 

$ pip install numpy pandas scikit-learn matplotlib 
seaborn jupyter numpy pandas install 


Once the libraries are installed we can set up a simple pipeline 
for data analysis. 


The first notebook 

The first step is to create a new notebook. From the command line 
we launch Jupyter using the following instruction: 

$ jupyter-notebook 


A screen similar to the one shown in Figure 1 will open. We create 
a notebook by selecting New > Python 3. Anew tab will open in our 
browser with the newly created notebook. Let’s take a moment 
to familiarize ourselves with the interface, shown in Figure 2, 
which resembles (very vaguely) an interactive command line, a 
top menu, and several options. 


The first thing that jumps out is the cell, one part of the view we 
can now see. The execution of single cells is initiated by the Run 
button and is independent from that of the other cells (we must 
keep in mind that the concept of scope of variables remains valid). 


The three buttons immediately to the right of the Run button 
allow you to stop, reboot and reset the kernel, i.e. the instance 
that Jupyter associates to our notebook. Restarting the instance 
may be necessary to reset the local and global variables associated 
with the script, which is especially useful when you are experi- 
menting with new methods and libraries. 





Another useful option is the one that allows you to select the cell 
type, choosing between Code (i.e. Python code), Markdown (useful 





a21 a87 a88 a89 a114 a115 a116 a117 a118 a120 ... a528 
count 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 1567.000000 .. 1567.000000 
mean 1.405054 2.401872 0.982420 1807.815021 0.945424 0.000123 747.383792 0.987130 58.625908 0.970777 6.395717 
std 0.016737 0.037332 0.012848 53.537262 0.012133 0.001668 48.949250 0.009497 6.485174 0.008949 ... 1.888698 
min 4.179700 2.242500 0.774900 1627.471400 0.853400 0.000000 544.025400 0.890000 52.806800 0.841100 2.170000 
25% 1.396500 2.376850 0.975800 1777.470300 0.938600 0.000000 721.023000 0.989500 57.978300 0.964800 4.895450 
50% 1.406000 2.403900 0.987400 1809.249200 0.946400 0.000000 750.861400 0.990500 58.549100 0.969400 6.410800 
75% 4.415000 2.428600 0.989700 1841.873000 0.952300 0.000000 776.781850 0.990900 59.133900 0.978300 7.594250 
max 4.453400 2.555500 0.993500 2105.182300 0.976300 0.041400 924.531800 0.992400 311.734400 0.982700 14.447900 
Figure 3: The first five lines of the SECOM dataset. 
at a2 a3 a4 a5 aô aT ag a9 aio... a582 a583 a584 a585 a586 a587 a588 a58 
0 3030.93 2564 2187.7333 1411.1265 1.3602 100 97.6133 0.1242 1.5005 0.0162 2? 0.5005 0.0118 0.0035 2.363 ? ? 
1 3095.78 2465.14 2230.4222 1463.6606 0.8294 100 102.3433 0.1247 1.4966 -0.0005 208.2045 0.5019 0.0223 0.0055 4.4447 0.0096 0.0201 0.00 
2 2932.61 2559.94 2186.4111 1698.0172 15102 100 95.4878 0.1241 1.4436 0.0041 82.8602 0.4958 0.0157 0.0039 3.1745 0.0584 0.0484 0.014: 
3 298872 2479.9 2199.0333 909.7926 1.3204 100 104.2367 0.1217 1.4882 -0.0124 .. 73.8432 0.499 0.0103 0.0025 2.0544 0.0202 0.0149 0.004. 
4 3032.24 2502.87 2233.3667 1326.52 15334 100 100.3967 0.1235 1.5031 -0.0031 ? 0.48 0.4766 0.1045 99.3032 0.0202 0.0149 0.004. 


5 rows x 591 columns 


Figure 4: Short statistical description of the SECOM dataset. 


for inserting comments and descriptions in the format used, for 
example, by GitHub READMEs), Raw NBContent (plain text) and 
Heading (offering a shortcut to insert titles). 


Importing and displaying data 

Once we are familiar with the interface we can move on to imple- 
ment our script. Here we import the libraries and modules that 
we will use: 


import numpy as np 

import pandas as pd 

import matplotlib.pyplot as plt 
ymatplotlib inline 

import seaborn as sns 

from ipywidgets import interact 


from sklearn.ensemble import RandomForestClassi fier 


from sklearn.impute import SimpleImputer 


from sklearn.model_selection import train_test_split 


from sklearn.preprocessing import StandardScaler 


from sklearn.metrics import confusion_matrix, 
accuracy_score 


from sklearn.utils import resample 


It is worth highlighting the instruction %matplotlib inline that 
allows us to display the graphs produced by Matplotlib correctly. 


Next, the data of the file containing the SECOM dataset is imported 
using the Pandas read_csv function. Note that, in this example, 
the relative path to the file is hardcoded for the sake of simplicity. 
However, it would be advisable to use the Python os package to 
allow our program to determine this path itself when required. 

data 


pd.read_csv(’data/secom.csv’ ) 


The previous instruction reads in the data contained in the secom. 
csv file, organizing it in a dataframe named data. We can display 
the first five lines of the dataframe through the head() instruction, 
as shown in Figure 3. 

data.head() 


Visualizing the first lines of the dataframe can be useful to have a 
first overview of the data to analyze. In this case we immediately 
notice the presence of some values equal to ‘“?’ that presumably 
represent null values. Moreover, it is evident that the range of the 
values vary greatly, a factor that we will have to keep in mind later 
on. We can also use the describe() function to get a quick overview 
of the statistical characteristics of each variable (Figure 4). 
data.describe() 


Statistical analysis can, in general, highlight conditions with a lack 
of normalcy (i.e., data distributed according to a non-parametric 
distribution), or the presence of anomalies. To offer an example, 
we note that the standard deviation (std) associated with the 
variables a116 and a118 is, proportionally, quite high, so we expect 
ahigh significance of these variables in their analysis. On the other 
hand, variables such as a114 have a low std, so they are expected to 
be discarded as they are not very explanatory with respect to the 
process being analyzed. 


Once the loading and display of the dataframe is complete, we 
can move on to a fundamental part of the pipeline: preprocessing. 


Preprocessing data 

As a first step we display the number of samples associated with 
each class. To do so, we will use the value_counts() function on 
the classvalue column as it contains the labels associated with 
each sample. 

data[’classvalue’]. value_counts() 


We see that there are 1463 samples collected in the normal operat- 
ing situation (class -1) and 104 in the failure situation (class 1). The 
dataset is therefore strongly imbalanced and it would be appropriate 
to undertake steps to make the distribution of samples between the 
different classes more ‘uniform’. This relates back to the intrinsic 
functionality of machine learning algorithms that learn on the basis 
of the data available to them. In this specific case, the algorithm will 
learn to characterize a situation of standard behavior successfully, 
but will have ‘uncertainties’ in characterizing abnormal situations. 
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Figure 5: Number of samples per class in SECOM dataset. 


The unbalance is even more evident when looking at the scatterplot 
(shown in Figure 5): 

sns.scatterplot(data.index, data[’classvalue’], alpha=0.2) 
plt.show() 


With this imbalance in mind (we'll come back to it later), we proceed 
to ‘separate’ the labels from the data: 

labels = data[’classvalue’ ] 

data.drop(’classvalue’, axis=1, inplace=True) 


Note the use of the axis parameter in the drop function that allows 
us to specify that the function must operte on the columns of the 
dataframe (by default, Pandas functions operate on the rows). 


Another aspect that can be extrapolated from the dataset analysis is 
that, in this specific version of SECOM data, many columns contain 
data of different types (i.e. both strings and numbers). As a result, 
Pandas is unable to uniquely determine the type of data with which 
each feature is represented and defers the definition of this to the 
user. Therefore, to bring all data into numerical format, it is neces- 
sary to use three functions offered by Pandas. 

















The first function we will use is replace (), with which we can replace 
all question marks with the constant value numpy.nan, the place- 
holder used to handle null values in Numpy arrays. 

data = data.replace(’?’, np.nan, regex=False) 





The first parameter of the function is the value to replace, the second 
is the value to use for the replacement, and the third is a flag indicat- 
ing whether or not the first parameter represents a regular expres- 
sion. We could also use an alternative syntax using the inplace 
parameter set to True, as follows: 

data.replace(’?’, np.nan, regex=False, inplace=True) 


The second and third functions that we can use to solve the problems 
highlighted above are the apply() and to_numeric() functions 
respectively. The first allows you to apply a certain function to all 
columns (or rows) of a dataframe, while the second converts a single 
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column into numeric values. By combining them we generate unique 
data and we will also remove the values that cannot be handled by 
Numpy and Scikit-Learn: 

data.apply (pd. to_numeric) 


We now need to evaluate which features among those contained in 
the dataset are actually useful. We typically use techniques (of higher 
or lower complexity) of feature selection to reduce redundancies and 
the size of the problem to be treated, delivering obvious benefits in 
terms of processing time and performance of the algorithm. In our 
case, we rely on a less complex technique that involves the elimina- 
tion of features of low variance (and therefore, as mentioned above, 
of low significance). We create, therefore, an interactive widget that 
allows us to visualize, in the form of a histogram, the distribution 
of data for each feature: 
@interact(col=(0, len(df.columns) - 1) 
def show_hist(col=1): 

data[’a’ + str(col)]. value_counts().hist(grid=False, 
figsize=(8, 6)) 





Interactivity is ensured by the decorator @interact, whose reference 
value (i.e. col) varies between o and the number of features present 
in the dataset. Exploring the displayed data through the widget, we 
will determine how many features assume a single value, meaning 
they can be simply overlooked in the analysis. We can then decide 
to eliminate them as follows: 

single_val_cols = data.columns[len(data) /data.nunique() 
<2] 

secom = data.drop(single_val_cols, axis=1) 





Of course, there are more relevant and refined feature selection 
techniques using, for example, statistical parameters. For a complete 
overview, the Scikit-Learn documentation can be consulted [6]. 


The last step is to deal with the null values (which we replaced previ- 
ously with np.nan). We inspect the dataset to see how many there 
are; to do so, we use a heatmap, as shown in Figure 6, where the 
white points represent the null values. 





sns.heatmap(secom.isnull(), cbar=False) 


Itis evident that many samples show a high percentage of null values 
that should not be considered in order to remove the bias effect on 
the data. 
na_cols = [col for col in secom.columns if secom[col]. 
isnull().sum() / len(secom) > 0.4] 

secom_clean = secom.drop(na_cols, axis=1) 


secom_clean.head() 


Thanks to the previous commands, a comprehension list has now 
isolated all features with more than 40% null values, allowing them 
to be removed from the dataset. 
The features with less than 40% of null values still need to be dealt 
with. Here we can use our first Scikit-Learn object, the SimpleIm- 
puter, which assigns values to all NaNs based on a user-defined strat- 
egy. In this case, we will use an average (mean) strategy, associating 
the average value assumed by the feature to each NaN. 

imputer = SimpleImputer (strategy=’mean’ ) 











secom_imputed = pd.DataFrame(imputer. 
fit_transform(secom_clean) ) 


secom_imputed.columns = secom_clean.columns 


As an exercise, we can verify that we have no zero values in the 
dataset through another heatmap (which, predictably, will assume a 
uniformly dark color). Then we can move on to the actual processing. 


Data processing 
We will divide our dataset into two sub-sets: one training and one test. 
This subdivision is necessary to mitigate the phenomenon of overfit- 
ting, which makes the algorithm ‘adhere too much’ to the data (see 
here for more background [7]), and ensures the the model's applica- 
bility to cases different from the ones upon which it was trained. To 
do this, we use the train_test_split function: 

X_train, X_test, y_train, y_test = train_test_split(secom_ 
imputed, labels, test_size=0.3) 
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Using the test_size parameter we can specify the percentage of data 
reserved for the test; the standard values for this parameter usually 
range between 0.2 and 0.3. 


It is also important to normalize the data. We have already noticed 
that some features assume values with much higher variation than 
others, and this will result in them being given more weight. Normal- 
izing them allows you to bring them within a single range of values 
so that there are no imbalances due to initial offsets. To do this, we 
use StandardScaler: 

scaler = StandardScaler() 

X_train = pd.DataFrame(scaler.fit_transform(X_train) , 
index=X_train.index, columns=X_train.columns) 

X_test = 
index=X_test.index, columns=X_test.columns) 


pd.DataFrame(scaler.fit_transform(X_test), 


Itis interesting to note the usefulness of the common interface offered 
by Scikit-Learn. Both scaler and imputer use the fit_transform 
method to process data that, in complex pipelines, greatly simplifies 
code writing and library understanding. 


We are now finally ready to classify the data. In particular, we will use a 
random forest [8], obtaining, after training, a model able to distinguish 
between normal and abnormal situations. We will verify the perfor- 
mance of the model identified in two ways. The first is the accuracy 
score. This is the percentage of samples belonging to the test set 
correctly classified by the algorithm. The second is the confusion matrix 
[9] that highlights the number of false positives and false negatives. 








First, we create the classifier: 
clf = RandomForestClassifier(n_estimators=500, 
max_depth=4) 


This creates a random forest with 500 estimators whose maximum 
depth is 4 levels. Now we can train our model on training data: 
clf -fit(X_train, y train) 


Figure 6: Map of null 
values in SECOM 
dataset. 
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Once the training is finished, the trained model is used to classify 
the test samples: 
y_pred = clf.predict(X_test) 


This results in two labels that relate to each of the two tests. The 
first one, belonging to y_test, represents the ‘truth’, while the 
second one, belonging to y_pred, is the value predicted by the 
algorithm. By comparing them we determine both the accuracy 
and the confusion_matrix. 
accuracy = accuracy_score(y_test, y_pred) ) 

cf = confusion_matrix(y_test, y_pred)) 


The example generates the following results: 
Model accuracy on test set is: 0.9341825902335457 
The confusion matrix of the model jis: 
[ [440 0] 
[ 31 0]] 


The accuracy, which is around 93%, is very good, so the model looks 
good. However, we note that the model is very accurate at classify- 
ing the samples of the predominant class, but equally inaccurate in 
classifying the samples belonging to the minority class. Thus a bias 
is evidently present. Therefore, we need a strategy to improve this 
situation. This can be performed by upsampling the data belonging 
to the minority class so as to balance, at least partially, the dataset. 
To do this we will use the Pandas resample function. 

normals = data[data[’classvalue’] == -1] 

anomalies = data[data[’classvalue’] == 1] 
anomalies_upsampled = resample(anomalies, replace=True, 
n_samples=Len(normals) ) 


This increases the size of the dataset in order to bring the number 
of normal samples closer to the number of abnormal samples. As 
a result we have to redefine both x and Y as follows: 

upsampled = pd.concat([normals, anomalies_upsampled] ) 
X_upsampled = upsampled.drop(’classvalue’, axis=1) 
y_upsampled = upsampled[’classvalue’ ] 


By performing the training again (including repeating the split 
and normalization procedures) we acquire the following results 


=— WEB LINKS 


for our example: 
Model accuracy on test set is: 0.8631921824104235 
The confusion matrix of the model is: 
[[276 41] 
[ 43 254]] 


We immediately notice that the accuracy of the model has 
decreased. This is presumably due to the greater heterogeneity 
induced in the dataset. However, looking at the confusion matrix, 
we immediately notice that the model has in reality improved its 
generalization capabilities, also succeeding in correctly classifying 
samples belonging to anomalous situations. 


Conclusions and references 

In this article we introduced a pipeline for the analysis of data from 
real processes in Python. It is clear, however, that each of the topics 
covered is extremely diverse and theoretical and practical experi- 
ence is essential if you want to seriously engage in data analysis. We 
also learned that you should not stop at the first result achieved, 
even in such complex situations such as the one discussed. Instead, 
it is necessary to interpret the results obtained from different points 
of view in order to discover the difference between a working model 
and a model that is, more or less obviously, distorted. 


The message to take home is then the following: data analysis 
cannot be a mechanical discipline, instead demanding a critical, 
in-depth and varied analysis of the phenomenon under observa- 
tion, guided by theoretical notions and practical skills. I can also 
highly recommend the references provided through which you 
can deepen your knowledge in some of the aspects touched on in 
the article, along with the link to the GitLab repository where you 
can consult the code written for this article. M 

200505-01 


This article was first published in Italian by Elettronica Open Source 


(https://it.emcelettronica.com). Elektor translated it with permission. 





[1] MATLAB GPU computing support: https://uk.mathworks.com/solutions/gpu-computing.html 


[2] Beginners guides for Python programming: https://wiki.python.org/moin/BeginnersGuide/Programmers 


[3] Python: www.python.org/ 
[4] Best practices for optimisation in MATLAB: 


https://uk.mathworks.com/videos/best-practices-for-optimisation-in-matlab-96756.html 


[5] UCI SECOM dataset: www.kaggle.com/paresh2047/uci-semcom/kernels 


[6] Scikit-Learn user guide: https://scikit-learn.org/stable/user_guide.html 


[7] Overfitting vs. underfitting: a complete example: 


https://towardsdatascience.com/overfitting-vs-underfitting-a-complete-example-d05dd7e19765 


[8] Understanding random forest: https://towardsdatascience.com/understanding-random-forest-58381e0602d2 


[9] Understanding confusion matrix: https://towardsdatascience.com/understanding-confusion-matrix-a9ad42dcfd62 


[10] GitLab repository for this article: https://gitlab.com/eos-acard/machine-learning-in-python 


106 January & February 2021 www.elektormagazine.com 


INTERACTIVE 





Project 20 


Corrections, Updates and Readers’ Letters 


By Ralf Schmiedel (Elektor) and Jens Nickell (Elektor) 


FN USB to S/PDIF Interface FN E-e-e-ternal Blinker 
September/October 2020 issue, page 6 (180027) July/August 2020 issue, page 65 (200200) 
RI The circuit diagram in Figure 5 and the parts list RJ There is an error in the circuit diagram: T1 to T3 
both give the wrong part number for IC1. The cor- are labelled as BC548C (NPN) transistors, but T3 
rect part is the PIC32MX270F256B-501/SO rather than the PIC- is shown as a PNP type. T3 should be a PNP type as marked 
32MX274F256B-I/SO. The printed circuit board is correct. and a BC558 can be used. 


New LCR Meter 50 Hz - 2 MHz 


November/December 2020 issue, page 6 (190311) 


RJ Due to a technical problem we published an old version of the article in the printed edition, we have to apologize for 
this! The PDF on the webpage shows the correct version, free download: 


www.elektormagazine.com/magazine/elektor-159/59096 


Questions or Comments? 
Do you have questions or comments? Then get in touch with 
Elektor by email at editor@elektor.com. 


How to Take (Successful) Photos of Electronics 
July/August 2020 issue, page 44 (200186) 


| found the article ‘How to Take (Successful) Photos of Electronics’ a 
fascinating read. However, it is possible to reduce the effort involved 
somewhat and leave the lens in your magnifier lamp without reducing 
the quality of the results. Very low-cost ring lights are available to fit all current SLR 
cameras and, despite their price, they are of good quality. In my photography | use a 
Fositan RF-550D that is available from Amazon for around £30. The unit comes with 
a wide range of adaptors to fit lenses of different diameters. If you are not the lucky 
owner of a macro lens then an add-on close-up lens can be used: use +2 dioptres to 
be on the safe side. When using the ring light it is necessary to put the camera into 
manual mode, setting the aperture and shutter speed by hand. At normal brightness 
(setting 0) and ISO 100 | have obtained good results at f/11 and 1/60 s. If the images 
are too dark then the ISO setting can be increased to 200. With these values it is also 
possible to work without a tripod. 

The light works very well in conjunction with my camera (a Canon 80D with 18-55 mm 
zoom lens) without having to dig into its more obscure settings. First the appropriate 
adaptor ring is threaded onto the front of the lens and then the control box can be 
mounted onto the flash bracket. The ring light itself is then attached to the adaptor. 


Volker Schmidt 
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Our Cégpmmunity in numbers 


Wovking on 
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Top 2) Embedded 
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Monthly learning habits 
[~ 68% learn electronics 
on YouTube 
GS 68.27 have vead an J 
electronics-velatea book = e kto r 


Ever wonder who makes up the Elektor community? 
Curious about what your peers think about topics 
such as IoT security, embedded programming, and 
home automation? Want to know if the average 
Elektor member has mastered more programming 
languages than you have? Ifyou answered “yes” to any 
of these questions, you're in luck. Elektor's editorial 
team regularly surveys the electrical engineers, 
electronics makers, and technical students who read 


our publications, use our online Labs platform, write Long-time venders 

for our magazines, and sell via Elektor.com. And we ; 

are constantly discussing technology with our highly 33% of Elektov 

engaged members via social media, email, online members have been 

events, and conferences. Get to know your fellow Elektor reading Flektov AAN AS 
community members. N 


Magazine fov 4 yeavs 


; 1; Jj... |, ov move! 
Want to get involved? Participating is simple: 
> Elektor E-Zine: www.elektormagazine.com/ezine 


> Elektor Labs: www.elektormagazine.com/labs 
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Getting to Know 


the Parallax Propeller 2 


An Introduction 


By Mathias Claußen (Elektor) 


Parallax put its new Propeller 2 chip — eight 
cores, half a megabyte of RAM and high- 
speed I/O with up to 300 MHz — into silicon. 
We received an evaluation board, so let's take 
a look at the Propeller 2 and its features. 


Figure 1: Parallax Propeller 2 Evaluation Board Rev.C. 


When Parallax introduced its first Propeller chip in 2006, it was 
something different than what we had seen before. In recent 
months, while working on the Propeller 2, Parallax has asked 
users and engineers to give feedback, as the first appearance of 
the chip was not in form of silicon but was given as bitstream for an 
Altera DE1o-Nano FPGA board. Over the time Parallax collected the 
feedback and went on to get the design for the Propeller 2 in silicon. 
Fortunately, the company wrote about the process in the Propeller 
forum so that the community can learn about the chip manufac- 
turing process. As I write this, Revision C silicon is approved for 
production. Let's take a look at the Propeller 2 and its features. 


The Propeller 2 

The chip is officially rated for 180 MHz clock speed, resulting in 
90 MIPS per core, and every instruction takes at least two clock 
cycles. Overclocking the Propeller 2 is possible and speeds beyond 
300 MHz can be reached, resulting in 150 MIPS per core. When 
it comes to CPU cores, your microcontroller has usually one, or 
sometimes two. The Propeller 2 has eight independent cores, called 
cogs, which provide a lot of computation power. All cogs share 
512 KB RAM on this model, and additional 512 x 32 Bit Registers 
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and 512 x 32 Bit Lookup RAM per core. Besides core count and 
RAM, the chip includes a whole set of interesting peripherals and 
features that include: 


> CORDIC solver with scale-factor correction 

> 16 semaphore bits with Atomic read-modify write 

> 64bit free running counter 

> USB 2.0 FS host and slave interface 

> Smart I/O pins (For more details, refer to the “Smart Pin 
Functions” textbox.) 


Parallax was kind enough to send us an evaluation kit (Figure 1) with 
a Revision C engineering sample on it, so that we could have a first 
look at and start playing. So I will use this article series to give you 
some insight into the chip, its peripherals, sample code, and more. 


A word of warning: as I write this, the chip is officially not released, 
so you should expect that we will hit some rough spots when it 
comes to software that might still be under construction. We were 
provided with not only the evaluation board, but also a stack of 
add-ons to test and play with (see Figure 2). 


The Propeller 2 has eight independent cores, called 
cogs, which provide a lot of computation power. 





SMART PIN FUNCTIONS 


> 8-bit, 120-Q (3 ns) and 1-kQ DACs with 16-bit oversampling, 
noise, and high/low digital modes 

> Delta-sigma ADC with five ranges, two sources, and VIO/GIO 
calibration 

> Several ADC sampling modes: automatic 2n SINC2, 
adjustable SINC2/SINC3, oscilloscope 

> Logic, Schmitt, pin-to-pin-comparator, and 8-bit-level- 
comparator input modes 

> 2/3/5/8-bit-unanimous input filtering with selectable 
sample rate 

> Incorporation of inputs from relative pins, -3 to +3 

> Negative or positive local feedback, with or without clocking 

> Separate drive modes for high and low output: 


Where have the peripherals gone? 

Wondering where the SPI, 12C and UART modules are? Those can 
be formed by using the smart pins and some code inside the cogs. 
Even if they are not directly on the feature map, they are avail- 
able. With this approach we will be able to output an HDMI signal 
directly to a monitor and display content from a flash chip. But 
that is planned for the end of this series. As an introduction to 


Questions or Comments? 

Do you have questions or comments about his article? Email 
the author at mathias.claussen@elektor.com or contact Elektor 
at editor@elektor.com. 
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Figure 2: Add-on baords for the Propeller 2 Evaluation board. 





logic/1.5 k/15 k/150 k/1 mA/100 pA/10 pA/float 

> Programmable 32-bit clock output, transition output, NCO/ 
duty output 

> Triangle/sawtooth/SMPS PWM output, 16-bit frame with 
16-bit prescaler 

> Quadrature decoding with 32-bit counter, both position and 
velocity modes 

> 16 different 32-bit measurements involving one or two signals 

> USB full-speed and low-speed (via odd/even pin pairs) 

> Synchronous serial transmit and receive, 1 to 32 bits, up to 
clock/2 baud rate 

> Asynchronous serial transmit and receive, 1 to 32 bits, up to 
clock/3 baud rate 


the individual peripherals and their special features will be quiet 
long and boring at the beginning, we are going to introduce them 
while we move along with the Propeller 2, so introducing them 
“On-Demand”. The next step will be a short look at the development 
environment and getting our first I/O pin to drivean LED. M 
200479-01 
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The Elektor Store 


Never expensive, always surprising 


The Elektor Store has developed from the that we ourselves are enthusiastic about or that 
community store for Elektor’s own products we simply want to try out. If you have a nice 

like books, magazines, kits and modules, into suggestion, we are here (sale@elektor.com). 

a mature webshop that offers great value for Our main conditions: 

surprising electronics. We offer the products never expensive, always surprising! 







Raspberry Pi 
Compute Module 4 
(CM4) 

Price: from €29.95 
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SeeedStudio DT71 
Mini Digital Smart Tweezers 


Price: €79.95 
Member Price: €71.96 


W wwweelektor.com/19422 
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DIY LiPo Supercharger Bundle 





DIY LiPo Supercharger kit 
(oy GreatScott!) 


Price: €24.95 
Member Price: €22.46 


W www.elektor.com/19525 





Raspberry Pi 400 — 
Raspberry Pi 4-based PC 


Price: €74.95 


RW www.elektor.com/19429 











SparkFun Qwiic Starterkit 
for Raspberry Pi 


Price: €69.95 
Member Price: €62.96 


PW www.elektor.com/19521 
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Hexadoku The Original Elektorized Sudoku 


Traditionally, the last page of Elektor magazine is reserved for our puzzle with an electronics 
slant: welcome to Hexadoku! Find the solution in the gray boxes, submit it to us by email, 
and you automatically enter the prize draw for one of five Elektor store vouchers. 


The Hexadoku puzzle employs numbers in the hexadecimal range 
o through F In the diagram composed of 16 x 16 boxes, enter 
numbers such that all hexadecimal numbers o through F (that's 
o-9 and A-F) occur once only in each row, once in each column 
and in each of the 4x4 boxes (marked by the thicker black lines). 





A number of clues are given in the puzzle and these determine 
the start situation. 


Correct entries received enter a prize draw. All you need to do is 
send us the numbers in the gray boxes. 


SOLVE HEXADOKU AND WIN! PARTICIPATE! 


Correct solutions received from Ultimately February 10th, 2021, 
the entire Elektor readership supply your name, street address 
automatically enter a prize draw and the solution (the numbers in the 
for five Elektor store vouchers gray boxes) by email to: 
oe worth €50.00 each, which should hexadoku@elektor.com 

File oie cone! wor """_ courage all Elektor readers to 
participate. 
PRIZE WINNERS 


The solution of Hexadoku in edition 6/2020 (November & December) is: F1235. 


The store vouchers have been awarded to: 
Huub Liebregts, G.D. (Joe) Young, Jean-Claude Carré, Ralf Boldt Velbert and R. Torfs. 


Congratulations everyone! 
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